API 接口與範例

協議要與所選模型及渠道相符。下方使用完整請求 URL；不要把控制台頁面當作接口地址。

Chat Completions

curl https://tokensclub.top/v1/chat/completions \
  -H "Authorization: Bearer $TOKENSCLUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_ENABLED_MODEL","messages":[{"role":"user","content":"只回覆 OK"}]}' 

Responses

curl https://tokensclub.top/v1/responses \
  -H "Authorization: Bearer $TOKENSCLUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_ENABLED_MODEL",
    "input": "Hello, TokensClub."
  }'

圖片生成（1K）

GPT 圖片模型目前只驗收 size=1024x1024（1K）的請求設定，按成功輸出張數計費。實際回傳尺寸可能不同；需要固定尺寸時請先檢查圖片。請使用 GPT 分組的 API Key；其他尺寸或品質設定尚未驗收。

curl https://tokensclub.top/v1/images/generations   -H "Authorization: Bearer $TOKENSCLUB_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"gpt-image-1","prompt":"A blue circle on white","n":1,"size":"1024x1024"}'

JavaScript：服務端請求

const response = await fetch("https://tokensclub.top/v1/responses", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TOKENSCLUB_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ model: "YOUR_ENABLED_MODEL", input: "只回覆 OK" })
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

串流與重試

需要串流時，按對應協議傳入 stream: true，並使用 SSE 解析器處理增量事件。斷線或超時後，先核對使用記錄；重試可能形成另一筆獨立用量。

圖片、工具調用、快取及長上下文的支援範圍取決於模型和渠道，不能由基本文字成功推斷。