YITOKEN API 文档
统一 AI 网关 · 完全兼容 OpenAI 接口规范,现有代码只需改一个 base_url。
快速开始
2
把 base_url 指向 YITOKEN
所有接口路径与 OpenAI 一致,只换域名。
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 当前提供 18 个模型:16 个视频生成、2 个图片生成。价格以人民币计。
图片生成 · 按次计费
| 模型 | 单价(额度单位) | 约合人民币 / 张 |
seedream-5.0-lite | 0.45 | ¥0.45 |
seedream-5.0-pro | 0.9 | ¥0.90 |
视频生成 · 按 token 计费
| 模型 | 倍率 | 约合人民币 / 百万 tokens |
doubao-seedance-2.0 | 36.225 | ¥72.5 |
doubao-seedance-2.0-480p-1080p | 23 | ¥46.0 |
doubao-seedance-2.0-480p-720p | 23 | ¥46.0 |
doubao-seedance-2.0-720p-1080p | 23 | ¥46.0 |
doubao-seedance-2.0-fast | 27.75 | ¥55.5 |
doubao-seedance-2.0-fast-480p-1080p | 18.5 | ¥37.0 |
doubao-seedance-2.0-fast-480p-720p | 18.5 | ¥37.0 |
doubao-seedance-2.0-fast-720p-1080p | 18.5 | ¥37.0 |
doubao-seedance-2.0-mini | 17.25 | ¥34.5 |
doubao-seedance-2.0-mini-480p-1080p | 11.5 | ¥23.0 |
doubao-seedance-2.0-mini-480p-720p | 11.5 | ¥23.0 |
doubao-seedance-2.0-mini-720p-1080p | 11.5 | ¥23.0 |
seedance-2.0 | 25.5 | ¥51.0 |
seedance-2.0-fast | 18.5 | ¥37.0 |
seedance-2.0-mini | 11.5 | ¥23.0 |
seedance-2.5 | 35 | ¥70.0 |
视频按生成内容的 token 数计费,token 数与时长、分辨率、帧率相关。
一条 5 秒 480p 视频约 5 万 tokens,一条 15 秒 720p 约 30 万 tokens。
计费说明
额度单位
账户余额以「额度」计,500,000 额度 = 1 单位。
充值时 ¥1 = 1 单位。
两种计费方式
| 方式 | 适用 | 算法 |
| 按次 | 图片生成 | 每次调用扣固定额度,与提示词长短无关 |
| 按 token | 视频生成 | 额度 = tokens × 模型倍率 |
预扣与结算
视频是异步任务,发起时按上限预扣一笔额度,任务完成后按实际用量结算,多退少不补。
任务失败全额退回。余额不足以覆盖预扣时,任务无法发起——这是最常见的失败原因。
接口
| 路径 | 用途 |
POST /v1/images/generations | 图片生成 |
POST /v1/video/generations | 提交视频生成任务,返回 task_id |
GET /v1/video/generations/{task_id} | 查询视频任务状态 |
GET /v1/models | 列出可用模型 |
GET /v1/dashboard/billing/usage | 查询用量 |
视频生成完整流程
# 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 | 令牌被禁用或超出限制 | 控制台检查令牌状态与额度上限 |
充值
控制台 → 钱包 → 充值,支持支付宝与微信扫码支付,到账即时。