Iymau API 文件

驗證與 API 金鑰

您的 API 金鑰用於驗證每一次請求。使用 Google 或電子郵件註冊即可立即獲得單一有效金鑰。請妥善保管此金鑰，因為它相當於該服務的密碼。如果您遺失了金鑰，可以產生新金鑰來取代舊的有效金鑰。系統按實際 token 用量收費，因此錯誤和拒絕回應均免費。您可以隨時使用加密貨幣充值。

Copycurl https://api.iyamau.com/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?"}]
  }'

首次使用聊天完成端點的請求

向聊天補全端點發送 POST 請求以生成文本。使用儀表板上提供的基礎 URL，以確保與標準客戶端的相容性。此專屬服務的模型識別碼始終為 "uncensored"。您可以調整 temperature 和 top_p 等參數以控制創意。系統接受標準的 JSON 載入，用於提示和訊息。錯誤不會消耗您的預付額度。此方法適用於您偏好的任何 OpenAI 相容 SDK。

Copyfrom openai import OpenAI

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

與 Node.js 客戶端的整合

使用官方 Node.js SDK 或任何相容函式庫與 API 互動。使用您的基礎 URL 和 API 金鑰配置客戶端。無審查模型回應標準訊息格式。您可以在單一請求中發送多個回合以獲取對話上下文。回應物件包含生成的文字和使用統計數據。支援串流以實現即時 token 交付。此方法可確保應用程式的低延遲。服務在我們的伺服器上處理繁重的工作。

Copyimport OpenAI from "openai";

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

串流回應與 SSE

透過將 stream 參數設為 true 來啟用串流。您會收到每個產生 token 的伺服器發送事件 (SSE)。這允許在文字產生時立即顯示。最後一個區塊包含請求的總 token 用量。此功能非常適合聊天介面和即時應用程式。它降低了終端使用者的感知延遲。您可以解析每個 SSE 事件中的 JSON 物件。uncensored 模型能高效地支援此標準協定。

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)

參數：temperature、top_p 與 JSON 模式

使用標準參數控制生成行為。設定 temperature 以調整隨機性，較高的值會增加創意。使用 top_p 過濾詞彙分佈。透過將 response_format 設為 json_object 來啟用 JSON 模式，以獲取結構化資料。uncensored 模型能可靠地遵循這些約束。您也可以指定 stop 序列以提前停止生成。Seed 值允許在測試期間獲得可重現的結果。這些選項讓您可以精確控制輸出品質。

速率限制、配額和常見錯誤

API 每支金鑰每秒鐘限制 300 次請求。您最多可有 8 個同時請求。每筆請求主體不得超過 8 MB。若收到 401 錯誤，請檢查您的 API 金鑰是否有效。402 錯誤表示預付信用額度不足；請透過加密貨幣充值以繼續服務。429 錯誤表示您已達到速率限制。等待幾秒鐘後再重試。上下文視窗總共支援 100,000 個 token。這允許進行大量的文件處理或長對話。