Models API 快速入門指南

基礎 URL 與驗證

API 端點為 https://api.modelsapi.cc/v1. 所有請求都需要在 Authorization 標頭. 您在儀表板上點擊「取得 API 金鑰」即可產生此金鑰。在您透過 Google 或電子郵件註冊後，金鑰會立即顯示。此過程無需提供手機號碼。金鑰與您的帳戶餘額及使用限制綁定。

發送您的第一個聊天完成請求

向以下網址發送 POST 請求 /v1/chat/completions 使用模型 ID uncensored. 請求主體必須包含 messages 包含您的提示的陣列。API 直接回傳文字回應。錯誤不會消耗您的預付信用額度。您可以透過發送簡單的問候語來驗證端點是否正常運作。

Copycurl https://api.modelsapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List five python libraries for data visualization"}]
  }'

Python SDK 整合

使用官方 OpenAI Python 程式庫與 API 互動。將 base URL 設定為我們的端點並提供您的 API 金鑰。此方法確保與現有程式碼庫的相容性。您可以執行個體化客戶端並呼叫聊天完成方法。回應物件包含產生的文字和 token 使用統計。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.modelsapi.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK 整合

Node.js SDK 遵循相同的配置模式。導入 OpenAI 套件並配置基礎 URL。在配置物件中傳遞您的 API 金鑰。此設置允許您使用熟悉的生成文本方法。庫自動處理 HTTP 請求。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.modelsapi.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

透過伺服器發送事件的串流回應

在請求主體中將 stream: true 在你的請求中。API 會隨著生成進度發送多個資料區塊。每個區塊包含部分回應。最後一個區塊包含總 token 用量。此方法能降低長輸出時的感知延遲。它非常適合即時應用程式。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

限制、錯誤與上下文視窗

上下文視窗總共支援 100,000 個 token。每次請求最多可輸出 16,000 個 token。錯誤會回傳 401 狀態碼表示金鑰無效，402 表示信用不足。速率限制在每分鐘 300 次請求後回傳 429。429 錯誤是暫時的。您的預付信用永不過期。錯誤不會扣除您的餘額。使用這些代碼在應用程式邏輯中優雅地處理失敗。