提交视频生成任务（文生视频 / 图生视频） — 异步任务模式，提交后返回 task_id 用于后续状态查询

提交视频生成任务。视频生成是 异步任务模式：本接口在通过校验后立即返回 task_id，调用方需通过获取视频生成任务状态接口轮询任务状态，待 status=completed 后即可下载视频。

项目	值
请求方法	`POST`
请求路径	`/v1/video/generations`
完整 URL	`https://api.amux.ai/v1/video/generations`
认证方式	`Authorization: Bearer <API_TOKEN>`
请求格式	`application/json`
响应格式	`application/json`

通用契约：本接口为跨厂商统一格式，amux-api 在网关层将通用请求自动转换为对应渠道（豆包 Seedance / 可灵 Kling / 即梦 Jimeng / 阿里 Wan 等）的原生请求；同时也提供 OpenAI Sora 兼容的别名路径 POST /v1/videos，请求体相同。

请求体参数

Prop

Type

透传策略：amux-api 通过 metadata 字段将厂商专属参数原样透传到上游。例如：

豆包 Seedance 系列可通过 metadata 传 aspect_ratio / camera_fixed / watermark 等
可灵 Kling 可传 negative_prompt / cfg_scale / mode / aspect_ratio / camera_control
即梦 Jimeng 可传 negative_prompt / aspect_ratio
阿里 Wan 可传 negative_prompt / prompt_extend

具体支持的字段以各模型上游文档为准。

请求示例

文生视频

curl https://api.amux.ai/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "doubao-seedance-2.0",
    "prompt": "一只戴着贝雷帽的可爱海獭幼崽，在樱花飘落的春日庭院中翻滚",
    "duration": 5,
    "width": 1280,
    "height": 720,
    "fps": 24,
    "metadata": {
      "aspect_ratio": "16:9"
    }
  }'

import os
import httpx

response = httpx.post(
    "https://api.amux.ai/v1/video/generations",
    headers={"Authorization": f"Bearer {os.environ['AMUX_API_KEY']}"},
    json={
        "model": "doubao-seedance-2.0",
        "prompt": "一只戴着贝雷帽的可爱海獭幼崽，在樱花飘落的春日庭院中翻滚",
        "duration": 5,
        "width": 1280,
        "height": 720,
        "fps": 24,
        "metadata": {"aspect_ratio": "16:9"},
    },
)

task = response.json()
print(f"Task ID: {task['task_id']}, Status: {task['status']}")

const response = await fetch('https://api.amux.ai/v1/video/generations', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.AMUX_API_KEY}`,
  },
  body: JSON.stringify({
    model: 'doubao-seedance-2.0',
    prompt: '一只戴着贝雷帽的可爱海獭幼崽，在樱花飘落的春日庭院中翻滚',
    duration: 5,
    width: 1280,
    height: 720,
    fps: 24,
    metadata: { aspect_ratio: '16:9' },
  }),
});

const task = await response.json();
console.log(`Task ID: ${task.task_id}, Status: ${task.status}`);

图生视频

curl https://api.amux.ai/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "kling-v2-master",
    "image": "https://example.com/source.jpg",
    "prompt": "镜头缓慢拉近，画面中的人物开始向前走",
    "duration": 5,
    "metadata": {
      "negative_prompt": "blurry, low quality",
      "cfg_scale": 0.7,
      "mode": "std",
      "aspect_ratio": "16:9"
    }
  }'

响应示例

{
  "task_id": "abcd1234efgh",
  "status": "queued"
}

响应字段

Prop

Type

任务状态枚举

status 字段可能的取值（详见获取任务状态）：

状态	含义
`queued`	已排队，等待执行
`in_progress`	生成中
`completed`	已完成（可下载视频）
`failed`	失败
`unknown`	未知状态（异常情况）

错误响应

{
  "error": {
    "message": "...",
    "type": "invalid_request_error",
    "param": "model",
    "code": "invalid_value"
  }
}

HTTP 状态码	含义
`200`	任务提交成功
`400`	请求参数错误（如 `model` 不支持视频生成、缺少必填字段等）
`401`	API 密钥无效或缺失
`403`	模型未授权或被内容安全策略阻止
`429`	触发速率限制或额度不足
`500` / `502` / `503`	服务端异常或上游不可用

下一步

获取视频生成任务状态 — 轮询任务进度，获取最终视频
豆包 Seedance 2.0 系列 — doubao-seedance-2.0 / doubao-seedance-2.0-fast 模型专属参数说明

创建视频生成任务