概览
万辰云提供统一的 AI API 接入层。当前模型广场开放一个异步视频模型：doubao-seedance-2-0-260128。 视频生成采用“提交任务、查询状态、下载结果”的异步流程。
模型类型
视频生成
调用模式
异步任务
端点协议
OpenAI Video
认证与地址
所有请求使用 Bearer Token 认证。API Key 只能在创建时完整显示， 请存放在服务端环境变量中，不要写入前端代码或公开仓库。
API 地址与认证头
BASE_URL=https://wanchenyun.com/v1Authorization: Bearer sk-your-api-key模型信息
| 模型 ID | doubao-seedance-2-0-260128 |
|---|---|
| 输入 | 文本、图片、参考视频 |
| 输出 | MP4 视频 |
| 分辨率 | 480p、720p、1080p、4K |
| 最长时长 | 15 秒 |
| 计费 | 按任务 usage token 计费 |
| 任务端点 | /v1/videos |
快速开始
第一步：创建视频任务。保存响应中的任务 ID。
POST /v1/videos
curl --request POST 'https://wanchenyun.com/v1/videos' \ --header 'Authorization: Bearer sk-your-api-key' \ --header 'Content-Type: application/json' \ --data '{ "model": "doubao-seedance-2-0-260128", "prompt": "一颗红色玻璃弹珠从木桌左侧滚向右侧，撞击透明玻璃杯。真实材质，自然光，连续单镜头。", "seconds": 5, "resolution": "720p" }'任务创建响应
{ "id": "task_example", "object": "video", "model": "doubao-seedance-2-0-260128", "status": "queued", "progress": 0, "created_at": 1792828145}第二步：轮询任务状态。当 status 为completed 时即可下载视频；失败时读取error。
GET /v1/videos/:task_id
curl --request GET 'https://wanchenyun.com/v1/videos/task_your_task_id' \ --header 'Authorization: Bearer sk-your-api-key'第三步：下载生成的视频文件。
GET /v1/videos/:task_id/content
curl --request GET 'https://wanchenyun.com/v1/videos/task_your_task_id/content' \ --header 'Authorization: Bearer sk-your-api-key' \ --output result.mp4请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| model | 是 | 固定使用 doubao-seedance-2-0-260128 |
| prompt | 是 | 视频内容、镜头、材质与运动描述 |
| seconds | 否 | 视频时长，按模型支持范围取值 |
| resolution | 否 | 480p、720p、1080p 或 4k |
| size | 否 | 预设分辨率或 WxH 尺寸 |
| image | 否 | 图片 URL，用于图生视频 |
| input_reference | 否 | 参考视频 URL，Seedance 2.0 支持 |
计费说明
视频模型采用任务计费。价格由分辨率、时长以及是否使用参考视频决定， 成功生成后按实际 usage token 结算。最终价格以模型广场的实时价格为准。
请在提交长视频或 4K 任务前确认账户额度。失败任务是否退款取决于失败类型和计费阶段。
错误处理
400请求参数错误
检查模型名称、分辨率、时长和 URL 参数
401认证失败
确认 API Key 正确且没有失效
402额度不足
检查账户余额或分组额度
429请求过于频繁
降低提交频率并遵循 Retry-After
502 / 503上游或服务暂不可用
稍后重试并查询任务状态