快速入門：用於影像管線的無審查文字 API

基礎 URL 與驗證

我們的 API 遵循標準的 OpenAI chat-completions 結構。若要開始，請前往取得 API 金鑰頁面，並使用電子郵件和密碼註冊。API 金鑰會立即顯示。試用期間不需要電話號碼或信用卡，但持續使用需要預付額度。

將您的基礎 URL 設定為https://api.imagegenapi.com/v1。將您的 API 金鑰包含在Authorization標頭中，作為 Bearer token。此設定適用於任何 OpenAI 相容的客戶端程式庫。使用的模型識別碼為uncensored，這是一個開放權重模型，針對合法成人用途進行微調，可無拒絕地回答。

發送提示詞

發送標準的chat.completions請求以生成文字。API 接受messages陣列中的訊息列表。它傳回包含補全內容的 JSON 物件。這非常適合一次性提示詞生成或不需要串流輸出的元資料編輯任務。

Copycurl https://api.imagegenapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

請求主體包含設定為 model 欄位，值為 uncensored 以及您的對話歷史。回應包含助手的回覆，您可以將其餵入影像產生管線，或用作標題。

Python SDK 整合

對於 Python 開發者，請使用官方的openai函式庫。設定base_url和api_key以指向我們的服務。這讓您可以利用熟悉的 Python 慣用法，同時存取我們的無審查模型。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.imagegenapi.com/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)

使用您的金鑰和正確的基礎 URL 初始化客戶端。使用您的訊息呼叫chat.completions.create()。此方法最適合批次處理，或當您需要直接在應用程式邏輯中解析 JSON 回應時。請記住，模型 ID 必須為uncensored。

Node.js SDK 用法

Node.js 開發者可以使用openai npm 套件。將baseURL設定為我們的端點。這對於需要非同步處理文字回應的伺服器端渲染或 API 閘道很有用。

Copyimport OpenAI from "openai";

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

使用您的 API 金鑰和基礎 URL 建立客戶端執行個體。呼叫chat.completions.create()以取得文字輸出。此方法適合生成腳本、標題，或在文字用於影像管線之前從文字中提取資訊。

串流輸出回應

若要進行即時文字生成，請透過設定 stream: true 啟用串流輸出。API 會回傳伺服器發送事件（SSE）串流，而非單一 JSON 物件。你必須在收到 delta 區塊時進行處理，以重建完整訊息。

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 MB。如果您超過限制，將收到429錯誤。如有需要，請重新產生金鑰，這將使舊金鑰失效。

若你的預付額度已耗盡，API 將拒絕請求。沒有免費的無限方案；你必須透過儲值來增加額度。401 錯誤表示 API 金鑰無效或缺失。請確保你的金鑰已正確設定在授權標頭中。上下文視窗為 100,000 token，包含提示詞加上補全內容。