创建视频任务
异步视频生成(文生视频 / 图生视频 / 多模态参考)。支持移动云 MoMA / MobileClaw、火山方舟,以及 AIYun-Router 的 Seedance V3 网关。提交后返回 task_id,再轮询查询接口获取视频 URL。输入、输出与结果会存档用于计费与审计。
上游路径兼容火山方舟 Ark /contents/generations/tasks。AIYun-Router 实际请求 https://cnapi.aiyunrouter.com/api/v3/contents/generations/tasks。若含参考视频输入,平台会按上游要求附加 Input-Has-Video 请求头(移动云)。
上游接口映射
| 移动云 / Ark 上游 | 本平台 API | 状态 | 说明 |
|---|---|---|---|
| POST /api/v3/contents/generations/tasks | POST /v3/contents/generations/tasks(同路径) 或 POST /v1/videos/generations | 已上线 | 火山规则用 /v3;OpenAI 风格用 /v1 |
| GET /api/v3/contents/generations/tasks/{id} | GET /v3/contents/generations/tasks/{id} 或 GET /v1/videos/generations/{id} | 已上线 | 查询任务 |
| GET /api/v3/contents/generations/tasks | GET /v3/contents/generations/tasks 或 GET /v1/videos/generations | 已上线 | 近 7 天任务列表;page_num / page_size / filter.status / filter.task_ids |
| DELETE /api/v3/contents/generations/tasks/{id} | DELETE /v3/contents/generations/tasks/{id} 或 DELETE /v1/videos/generations/{id} | 已上线 | queued 取消;succeeded / failed / expired 删除记录 |
| POST /v3/mapping/query | — | 内部 | 平台路由校验,不对客户暴露 |
| 移动云 AICC 素材库 OpenAPI | POST /v1/assets/groups|items 等 | 已上线 | 见「素材库」;亦兼容 POST /v1/assets?Action=… |
接入建议:原火山 / 移动 SDK 将 baseURL 改为 https://ai.pengyoo.com/api/v3,路径保持 /contents/generations/tasks 即可;OpenAI 兼容客户端继续用 /v1。
使用 asset:// 引用素材时,请先通过素材库入库, 轮询至 Active 后再创建视频任务。详见素材库。
鉴权
所有 /v1/* 接口均必须携带平台 API Key:Authorization: Bearer sk-pyo-...。Key 在 控制台 → API Keys 创建。上游移动云等供应商 Key 由平台托管,客户无需直接使用。
文生视频(火山路径,推荐 Seedance 客户)
curl -X POST "https://ai.pengyoo.com/api/v3/contents/generations/tasks" \
-H "Authorization: Bearer <OPENMODELS_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2.0",
"content": [
{ "type": "text", "text": "一只橘猫在阳光下伸懒腰,电影感光影" }
],
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true
}'文生视频(OpenAI 风格 /v1)
curl -X POST "https://www.openmodels.com.cn/v1/videos/generations" \
-H "Authorization: Bearer <OPENMODELS_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "chinamobile-seedance-2.0",
"prompt": "雨夜霓虹街头,电影运镜,慢镜头",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true,
"watermark": false
}'多模态 content 格式
curl -X POST "https://www.openmodels.com.cn/v1/videos/generations" \
-H "Authorization: Bearer <OPENMODELS_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "chinamobile-seedance-2.0",
"content": [
{ "type": "text", "text": "无人机航拍秋日山谷,金黄森林与蜿蜒河流" }
],
"duration": 8,
"resolution": "1080p",
"ratio": "16:9"
}'| 字段 | 说明 |
|---|---|
| model* | 固定为 chinamobile-seedance-2.0 |
| prompt | 文生视频提示词(与 content 二选一) |
| content | 多模态输入数组,元素 type 可为 text / image_url / video_url / audio_url;图片/视频/音频 URL 支持公网地址或 asset://<id> |
| duration | 视频时长(秒),4–15 |
| resolution | 480p / 720p / 1080p,默认 720p |
| ratio | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive |
| generate_audio | 是否生成同步音频,默认 true(与火山方舟一致);传 false 为无声 |
| watermark | 是否添加水印,默认 false |
| return_last_frame | 是否返回尾帧图片 URL |
| tools | 工具列表,如 [{"type":"web_search"}] 开启联网搜索 |
| callback_url | 任务状态变更回调地址(透传上游) |
| seed | 随机种子,-1 表示随机 |
使用素材库 asset://(推荐大图/多参考)
先调用素材库上传并等待 status=Active,再在image_url.url 中填asset://<asset_id>。
curl -X POST "https://www.openmodels.com.cn/v1/videos/generations" \
-H "Authorization: Bearer <OPENMODELS_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "chinamobile-seedance-2.0",
"content": [
{ "type": "text", "text": "将图片1缓慢推近,电影感光影" },
{
"type": "image_url",
"image_url": { "url": "asset://asset-xxxxxxxx" },
"role": "reference_image"
}
],
"duration": 5,
"resolution": "720p",
"ratio": "16:9"
}'响应
响应体对齐火山 Ark / 移动云 Seedance 原文。status、error、usage、duration、resolution、ratio、content 等执行结果按上游透传。model 回显创建请求里的平台 id,查询全程不变,不改写成上游内部版本号(例如上游返回 doubao-seedance-2-0-260128 时,对客仍是请求里的 chinamobile-seedance-2.0)。成片只在 content.video_url(上游原文链接)。尾帧在 content.last_frame_url。不额外返回 result_url / 顶层 last_frame_url。error 与火山一致:成功为 null,失败为 { code, message }。请求时可传 doubao-seedance-2.0 或平台 id chinamobile-seedance-2.0。
{
"id": "cgt-20260822120000-xxxxx",
"model": "chinamobile-seedance-2.0",
"status": "queued",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true,
"error": null,
"created_at": 1724328000
}