Seedance 2.0 — U-Token 通用币 Docs

对外模型 ID 固定为 seedance-2.0。支持 480p、720p、1080p 和 4k，省略 input.resolution 时默认使用 480p。接口不接受或返回内部上游模型 ID。

Seedance 2.0 系列只使用官方 API 中转渠道。先在控制台为 API Key 授权对应模型，再调用异步媒体任务接口。

生成模式

模式	`task`	输入要求
文生视频	`Txt2Video`	`input.prompt` 非空，图片、视频和音频数组为空
图生视频	`Img2Video`	`input.images` 包含 1 个公网可访问的素材 URL
首尾帧视频	`Img2Video`	`input.images` 按首帧、尾帧顺序包含 2 个素材 URL
全能参考	`OmniVideo`	`input.images`、`input.videos`、`input.audios` 至少一项非空

参考素材必须是非空字符串 URL。本地文件或 Base64 输入请先通过文件上传转换为公网 URL。创建图生视频或全能参考任务时，平台会立即受理请求，再在后台将这些 URL 上传到当前任务使用的上游素材库并创建视频任务；调用方无需获取或传入 asset:// 地址。

请求参数

参数	必填	说明
`task`	是	`Txt2Video`、`Img2Video` 或 `OmniVideo`
`model`	是	本页固定为 `seedance-2.0`
`input.prompt`	文生必填	视频内容描述；文生视频必须是非空字符串
`input.images`	按模式	图生视频传 1 张，首尾帧传 2 张；全能参考最多传 9 张
`input.videos`	否	全能参考最多传 3 个视频；非空时使用“有视频输入”单价
`input.audios`	否	全能参考最多传 3 个音频
`input.resolution`	否	`480p`、`720p`、`1080p` 或 `4k`；默认 `480p`
`input.aspect_ratio`	否	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9` 或 `adaptive`；省略则不传
`input.duration`	否	正数，单位为秒，默认 `5`；可用时长由当前模型服务能力决定
`input.generate_audio`	否	布尔值；请求生成输出音频，与作为参考素材的 `audios` 不同
`input.pass_through`	否	透传当前上游支持的扩展参数；平台不保证未文档化字段长期稳定
`callback_url`	否	可选的公网 HTTPS 回调地址。见媒体任务回调。

callback_url 不会转发给上游。仍可用平台任务 ID 轮询结果。

请求示例

以下 JSON 均为 POST /v1/router/task/create 的请求体。请求头使用 Authorization: Bearer sk-你的KEY，也可以使用 x-api-key: sk-你的KEY。

文生视频

{
  "task": "Txt2Video",
  "model": "seedance-2.0",
  "input": {
    "prompt": "电影感的山间日出，云海缓慢流动",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "generate_audio": true
  }
}

图生视频

{
  "task": "Img2Video",
  "model": "seedance-2.0",
  "input": {
    "prompt": "让画面中的云层缓慢流动，镜头平稳向前推进",
    "images": ["https://assets.example.com/input.png"],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }
}

首尾帧视频

input.images 中第一张是首帧，第二张是尾帧。

{
  "task": "Img2Video",
  "model": "seedance-2.0",
  "input": {
    "prompt": "镜头从清晨自然过渡到黄昏",
    "images": ["https://assets.example.com/first.png", "https://assets.example.com/last.png"],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }
}

全能参考

以下请求同时使用图片、视频和音频参考素材。只要三个素材数组中至少一个非空，也可以仅传其中一种或两种。

{
  "task": "OmniVideo",
  "model": "seedance-2.0",
  "input": {
    "prompt": "沿用参考视频的运镜，以参考音频作为背景音乐，并保持参考图片的产品外观",
    "images": ["https://assets.example.com/product.png"],
    "videos": ["https://assets.example.com/camera-motion.mp4"],
    "audios": ["https://assets.example.com/background-music.mp3"],
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "pass_through": {}
  }
}

异步任务查询与响应

创建成功响应会立即返回平台 tsk_* 任务 ID。其他成功字段不能作为固定结构依赖。参考素材上传和上游视频任务创建在后台继续执行。每隔 3～5 秒轮询 GET /v1/router/tasks/{task_id}；API Key 只能查询同一买家创建的任务。

{ "code": 200, "message": "success", "task_id": "tsk_0f3c9a72b1e04d5f" }

查询请求没有请求体。使用有权访问该任务的 API Key，将创建响应中的平台任务 ID 放进路径；查询同样接受 x-api-key 请求头：

GET https://u-token.ai/v1/router/tasks/tsk_0f3c9a72b1e04d5f
Authorization: Bearer sk-你的KEY

{ "task_id": "tsk_0f3c9a72b1e04d5f", "status": 1, "results": [] }

状态	含义
`0`	排队中
`1`	处理中；usage 不可计费或余额不足时也会保持此状态继续重试
`2`	成功；已完成结算，可以读取视频 URL 和用户实付 `cost`
`3`	失败；不扣费
`4`	已取消；不扣费

{
  "task_id": "tsk_0f3c9a72b1e04d5f",
  "status": 2,
  "result": {
    "content": { "video_url": "https://static.example.com/video.mp4" },
    "resolution": "720p",
    "usage": { "total_tokens": 50638 }
  },
  "cost": 42.54
}

查询已失败的终态仍返回 HTTP 200；响应体的业务错误码为 code=424，并提供可追踪的请求 ID，不返回供应商原始诊断信息。

{
  "code": 424,
  "message": "Provider error (request id: aitk-...)",
  "task_id": "tsk_0f3c9a72b1e04d5f",
  "status": 3,
  "fail_reason": "Provider error (request id: aitk-...)",
  "error_message": "Provider error (request id: aitk-...)"
}

Token 计费

分辨率	无视频输入	有视频输入
`480p`、`720p`	$7.0 / 100 万 tokens	$4.3 / 100 万 tokens
`1080p`	$7.7 / 100 万 tokens	$4.7 / 100 万 tokens
`4k`	$4.0 / 100 万 tokens	$2.4 / 100 万 tokens

计费档位优先使用终态 result.resolution，缺失时回落到请求分辨率。Token 数优先使用正整数 result.usage.total_tokens，缺失时回落到 completion_tokens。查询响应中的 cost 是本次实际扣除的 credits，并已应用账户价格系数。

Token 任务创建时不预扣。usage 缺失、不是正整数或余额不足时，平台不会交付 video_url，任务保持 status=1 并继续重试结算；失败或取消任务不扣费。

参数错误

不支持的 task、空文生提示词、错误的素材数组或不支持的分辨率返回 HTTP 400，且不会调用上游。
Img2Video 必须传 1 或 2 张图片；OmniVideo 必须至少传一种参考素材，且最多传 9 张图片、3 个视频和 3 个音频。
任一后台参考素材上传失败或超时，任务会进入终态 status=3；视频任务不会提交到上游，也不会扣费。请使用平台任务 ID 查询中性化后的供应商错误。
API Key 未授权模型、模型未开放或请求内部上游模型名时返回 HTTP 403。

Fast 与 Mini 的调用流程和模式相同，仅公开模型 ID、分辨率能力与价格不同，详见 Seedance 2.0 Fast 和 Seedance 2.0 Mini。

On this page