YITOKEN YITOKENAPI 文档

YITOKEN API 文档

统一 AI 网关 · 完全兼容 OpenAI 接口规范,现有代码只需改一个 base_url

快速开始

1
注册并获取令牌 登录 yitoken.com.cn → 控制台 → 令牌 → 新建,复制形如 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 当前提供 18 个模型:16 个视频生成、2 个图片生成。价格以人民币计。

图片生成 · 按次计费

模型单价(额度单位)约合人民币 / 张
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。

计费说明

额度单位

账户余额以「额度」计,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令牌被禁用或超出限制控制台检查令牌状态与额度上限

充值

控制台 → 钱包 → 充值,支持支付宝微信扫码支付,到账即时。