立即注册

百炼视频 · 平台异步任务

百炼视频 · 平台异步任务 API（推荐）

适用模型：百炼侧全部视频 modelKey（见 modelKey 速查表）。

端点

POST /api/ai/tasks
GET  /api/ai/tasks/{taskId}

文生视频

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "wan2.7-t2v",
    "callbackId": "vid-001",
    "videoParams": {
      "prompt": "一只猫在草地上奔跑，电影感",
      "duration": 5,
      "resolution": "720p",
      "aspectRatio": "16:9"
    }
  }')
echo "$TASK"

TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

status=completed 时从 resultUrlPublic 取视频地址。建议每 2~5 秒轮询，或使用 Webhook 回调。

图生视频（首帧）

{
  "modelKey": "wan2.6-i2v",
  "videoParams": {
    "prompt": "镜头缓慢推进",
    "firstFrame": "https://example.com/frame.jpg",
    "duration": 5
  }
}

参考生视频 / 视频编辑

  • 参考图：videoParams.refImages
  • 模型 wan2.7-r2v、wan2.7-videoedit、happyhorse-1.0-video-edit 等 — 参数见 万相 2.7、HappyHorse

平台入参

字段必填说明
modelKey是JELLYTOKEN 模型 ID
callbackId建议幂等 ID
callbackUrl否Webhook 地址
requestContext否透传键值
videoParams.prompt建议提示词
videoParams.firstFrame / lastFrame否首尾帧 URL（图生视频）
videoParams.refImages否参考图 URL 数组
videoParams.duration否时长（秒）
videoParams.resolution否如 720p、1080p
videoParams.aspectRatio否如 16:9
videoParams.extraParamsJson否平台已支持的厂商扩展字段（JSON 字符串）

完整说明见 异步任务（图像/视频/文本）。
系列文档：万相 2.5/2.6、万相 2.7、HappyHorse。

平台出参

提交响应：taskId、status: queued。

查单 GET /api/ai/tasks/{taskId}：

字段说明
statuspending / running / completed / failed / cancelled
progress执行进度 0–100
resultUrlPublic完成后的视频 URL（优先使用）
error / errorCode失败原因

Webhook 字段见 Webhook 回调。

厂商全量参数

百炼侧镜头、音频、编辑指令等完整字段以官方文档为准；平台已支持的扩展键可通过 videoParams.extraParamsJson 传递：