單一 API：快速開始指南

基礎 URL 與驗證

首先將你的用戶端指向我們的專屬端點。此 openai compatible api 使用標準驗證標頭，因此你只需在設定中更改兩個值。

基礎 URL 為 https://api.onekeyllmapi.com/v1。請在註冊頁面生成您的專屬 API 金鑰。開始使用無需綁定信用卡，金鑰將在註冊完成後立即顯示。請妥善保管金鑰，它將用於驗證所有服務請求。

基本補全

發送簡單的文字提示詞以獲取直接回應。這是我們 ai api for developers 服務的基礎。模型會返回無內容拒絕的文字，適合合法成人用途，非常適合創意或無限制任務。

• 模型 ID：uncensored
• 端點：POST /v1/chat/completions
• 上下文：100,000 個 token

使用此範例進行你的第一次請求：

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

Python SDK 整合

使用官方 OpenAI Python 函式庫與我們的服務互動。唯一需要更改的是 base_url 和 api_key。這確保你的現有邏輯無需修改即可運作。

• 透過 pip install openai 安裝
• 設定環境變數或在用戶端初始化時直接傳入
• 照常呼叫 chat.completions.create()

像這樣配置用戶端：

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.onekeyllmapi.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 SDK 用法

使用標準 OpenAI Node 套件整合至 JavaScript 或 TypeScript 專案。將用戶端指向我們的 URL 並提供金鑰。此方法與任何 OpenAI 相容的用戶端結構保持相容。

• 透過 npm install openai 安裝
• 使用自訂基礎 URL 初始化
• 使用標準的 async/await 模式

初始化範例：

Copyimport OpenAI from "openai";

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

串流回應

以 token 為單位接收回應以降低感知延遲。我們的 streaming api 支援伺服器傳送事件 (SSE)，允許你在生成時顯示輸出。這非常適合聊天介面或即時應用程式。

• 在請求中設定 stream: true
• 在用戶端解析 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 支援 100k 上下文 API 視窗，可處理長文件或對話。請求的請求主體大小限制為 8 MB。

常見錯誤包括 401（金鑰無效）、402（預付額度耗盡）以及 429（超過每分鐘 300 次請求）。隨用隨付額度永不過期，且你可從 $10 起儲值。支援函式呼叫以執行函式。