API ia 快速入門指南

驗證與 Base URL

使用您的唯一 API 金鑰處理對 https://api.apiia.cc/v1 基礎 URL。此 OpenAI-compatible 端點適用於任何標準 SDK，只需設定基礎 URL 並在 Authorization header。註冊後透過 Google 或電子郵件即可立即產生金鑰，無需提供手機號碼。請妥善保管您的金鑰，因為它可直接存取您的預付餘額。您可以隨時產生新金鑰，舊金鑰將立即失效。

傳送您的第一個完成請求

向以下網址發送 POST 請求 /v1/chat/completions 將模型設定為 "uncensored"。這個簡單的文本輸入、文本輸出介面處理您的提示，針對合法成人用途不進行內容拒絕。您可以使用來控制回應長度 max_tokens 參數，若省略則預設為 2,048。該模型支援 100,000 個記號的上下文視窗，允許大量的提示歷史。使用此端點進行可靠、無過濾的文本生成。

Copycurl https://api.apiia.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

Python SDK 集成

安裝官方 OpenAI Python 套件，並將基礎 URL 設定為指向我們的服務。這使您能夠使用熟悉的方法，例如 chat.completions.create() 使用我們的 uncensored 模型。SDK 會自動處理 tokenization 和請求格式化。您可以傳遞如 temperature 和 top_p 控制創意和隨機性。這種方法簡化了集成到現有的 Python 應用程序或數據科學工作流程中。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiia.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 整合

使用 OpenAI Node.js SDK，設定 BASE_URL 環境變數或設定客戶端實例。這能與 JavaScript 和 TypeScript 專案無縫整合。SDK 支援所有標準的聊天完成功能，包括函式呼叫和 JSON 模式。您可以輕鬆在串流和非串流模式之間切換。這種靈活性使其非常適合構建需要無審查文字生成的 Web 應用程式或無伺服器函式。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiia.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);

帶有 SSE 的串流回應

在請求主體中將 stream: true 在您的請求中。API 隨著 token 生成返回伺服器發送事件 (SSE)。這提供即時回饋，降低終端使用者的感知延遲。最後一個區塊包含 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)

限制、錯誤與上下文視窗

您的 API 金鑰限為每分鐘 300 次請求和 8 個併發請求。最大請求主體大小為 8 MB。如果收到 401 錯誤，請檢查您的 API 金鑰有效性。402 錯誤表示預付餘額不足。429 錯誤表示您已超過速率限制。上下文視窗支援提示詞和完成詞合計 100,000 個權杖。了解這些限制有助於您設計能優雅處理錯誤的強大應用程式。