视频 API

通过稳定的 BeatAPI 模型 ID 创建一个异步视频生成任务。

每个模型页会列出全部字段、默认值、枚举、组合限制、请求示例、响应和错误行为。

查询可用模型

GET /v1/media/models?media_type=video 无需鉴权。

$
curl "https://api.beatapi.io/v1/media/models?media_type=video"

1
{
2
  "data": {
3
    "object": "list",
4
    "data": [{
5
      "id": "minimax-h3",
6
      "object": "generation_model",
7
      "name": "MiniMax H3",
8
      "media_type": "video",
9
      "input_modes": ["text", "frames", "reference"]
10
    }]
11
  }
12
}

id 是稳定公开模型别名；input_modes 可能包含 text、image、frames 或 reference。内部供应商路由不属于公开契约。

通用创建契约

POST /v1/videos/tasks

请求体必须且只能匹配一个模型参数结构；model 是判别字段，未知字段会被拒绝。

$
curl https://api.beatapi.io/v1/videos/tasks \
>
  -X POST \
>
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
>
  -H "Idempotency-Key: video-seedance-2-5-001" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "model": "seedance-2.5",
>
    "prompt": "雨夜市场中的电影感跟拍镜头。",
>
    "duration": 5,
>
    "aspect_ratio": "16:9",
>
    "resolution": "720p"
>
  }'

成功请求返回 201 Created 和 data.id。每 5–10 秒轮询 GET /v1/tasks/{task_id}，成功结果位于 data.output.media[] 和 data.output.r2_url。相同幂等请求会返回已接受任务；同一键配不同请求体返回 409 idempotency_conflict。

通用错误

错误响应包含 error.code、error.message、error.request_id 和可选的 error.retry_after_seconds。模型页面是最终生产请求契约。