创建视频任务

异步视频生成(文生视频 / 图生视频 / 多模态参考)。支持移动云 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/tasksPOST /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/tasksGET /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 素材库 OpenAPIPOST /v1/assets/groups|items 等已上线见「素材库」;亦兼容 POST /v1/assets?Action=…

接入建议:原火山 / 移动 SDK 将 baseURL 改为 https://ai.pengyoo.com/api/v3,路径保持 /contents/generations/tasks 即可;OpenAI 兼容客户端继续用 /v1。

使用 asset:// 引用素材时,请先通过素材库入库, 轮询至 Active 后再创建视频任务。详见素材库。

POST/v1/videos/generations已上线
POST/v3/contents/generations/tasks已上线

鉴权

所有 /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
resolution480p / 720p / 1080p,默认 720p
ratio16: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
}