YITOKEN YITOKENAPI 文件

YITOKEN API 文件

統一 AI 閘道 · 完全相容 OpenAI 介面規範,現有程式碼只需改一個 base_url。

快速開始

1
註冊並取得金鑰 登入 yitoken.com.cn → 控制台 → API 金鑰 → 建立,複製形如 sk-xxxxxx 的金鑰。
2
把 base_url 指向 YITOKEN 所有介面路徑與 OpenAI 一致,只換網域。
3
發起第一次呼叫 下面的範例會生成一張圖片。

curl

curl https://yitoken.com.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-5.0-lite","prompt":"a red bicycle","n":1}'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的金鑰",
    base_url="https://yitoken.com.cn/v1",
)

resp = client.images.generate(
    model="seedream-5.0-lite",
    prompt="a red bicycle leaning on a brick wall",
    n=1,
)
print(resp.data[0].url)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-你的金鑰',
  baseURL: 'https://yitoken.com.cn/v1',
});

const r = await client.images.generate({
  model: 'seedream-5.0-lite',
  prompt: 'a red bicycle',
});
console.log(r.data[0].url);

模型與價格

YITOKEN 提供字節跳動 Seedance 系列影片生成模型、Seedream 與無界 noimg 圖片生成模型,以及 GPT-6.1 Sol 文字模型。完整模型清單與即時價格以 模型與價格 頁為準,價格以人民幣計。

圖片生成 · 按次計費

模型單價(額度單位)約合人民幣 / 張
seedream-5.0-lite0.45¥0.45
seedream-5.0-pro0.9¥0.90

影片生成 · 按 token 計費

模型倍率約合人民幣 / 百萬 tokens
doubao-seedance-2.036.225¥72.5
doubao-seedance-2.0-480p-1080p23¥46.0
doubao-seedance-2.0-480p-720p23¥46.0
doubao-seedance-2.0-720p-1080p23¥46.0
doubao-seedance-2.0-fast27.75¥55.5
doubao-seedance-2.0-fast-480p-1080p18.5¥37.0
doubao-seedance-2.0-fast-480p-720p18.5¥37.0
doubao-seedance-2.0-fast-720p-1080p18.5¥37.0
doubao-seedance-2.0-mini17.25¥34.5
doubao-seedance-2.0-mini-480p-1080p11.5¥23.0
doubao-seedance-2.0-mini-480p-720p11.5¥23.0
doubao-seedance-2.0-mini-720p-1080p11.5¥23.0
seedance-2.025.5¥51.0
seedance-2.0-fast18.5¥37.0
seedance-2.0-mini11.5¥23.0
seedance-2.535¥70.0
影片按生成內容的 token 數計費,token 數與時長、解析度、影格率有關。 一支 5 秒 480p 影片約 5 萬 tokens,一支 15 秒 720p 約 30 萬 tokens。

文字 · 按 token 計費

模型分組輸入輸出快取讀取快取寫入
gpt-6.1-solGPT Codex¥0.55¥2.75¥0.0275¥0.6875
單價為每百萬 tokens,適用於 272K 以內的上下文;超過 272K 時各項單價加倍。

計費說明

額度單位

帳戶餘額以「額度」計,500,000 額度 = 1 單位。 儲值時 ¥1 = 1 單位。

兩種計費方式

方式適用算法
按次圖片生成每次呼叫扣固定額度,與提示詞長短無關
按 token影片生成額度 = tokens × 模型倍率

預扣與結算

影片是非同步任務,發起時按上限預扣一筆額度,任務完成後依上游回傳的實際用量結算,多退少補:實際用量低於預扣的退回差額,高於預扣的補扣差額。 任務失敗全額退回。餘額不足以支付預扣時,任務無法發起——這是最常見的失敗原因。

介面

路徑用途
POST /v1/images/generations圖片生成
POST /v1/video/generations提交影片生成任務,回傳 task_id
GET /v1/video/generations/{task_id}查詢影片任務狀態
POST /v1/chat/completions文字對話(GPT-6.1 Sol)
POST /v1/responsesResponses 介面,Codex 命令列等用戶端使用
GET /v1/models列出可用模型
GET /v1/dashboard/billing/usage查詢用量

文字模型呼叫範例

curl https://yitoken.com.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"你好"}]}'

Codex 命令列等使用 Responses 介面的用戶端,把 base_url 設為 https://yitoken.com.cn/v1 即可。

影片生成完整流程

# 1. 提交任務
curl https://yitoken.com.cn/v1/video/generations \
  -H "Authorization: Bearer sk-你的金鑰" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0-mini","prompt":"a paper boat on a stream","metadata":{"resolution":"480p"}}'

# → {"task_id":"task_xxx","status":"queued"}

# 2. 輪詢狀態(約 1-3 分鐘)
curl https://yitoken.com.cn/v1/video/generations/task_xxx \
  -H "Authorization: Bearer sk-你的金鑰"

常見錯誤

回傳含義怎麼辦
401 Invalid token金鑰無效或已刪除檢查 Authorization: Bearer sk-...,注意 sk- 前綴不能漏
model_not_found模型名稱寫錯,或該模型未對你的分組開放用 /v1/models 確認可用的模型名稱
insufficient_quota餘額不足,或不足以支付影片任務的預扣儲值後重試
403金鑰已停用或超出限制到控制台檢查金鑰狀態與額度上限

儲值

控制台 → 錢包 → 儲值,支援支付寶與微信掃碼付款,即時入帳。