调用视频API指南

请注意，本站已内置视频中心，可简化调用过程。

VIDEO API - 视频生成

创建“Grok-Heavy号池组”分组或者“国产视频模型”分组密钥后即可调用。视频生成为异步任务，推荐调用流程如下：

  1. 提交任务，保存返回的 task_id
  2. 轮询查询任务状态
  3. 任务完成后下载视频

⚠️ 注意：请勿对同一个任务重复提交。

接口列表

HTTP 方法 Endpoint 说明
POST /v1/videos 创建视频生成任务
GET /v1/videos/{task_id} 查询任务处理状态
GET /v1/videos/{task_id}/content 下载生成的视频

分辨率与计费规则

按网站货币计价，下表价格均为每个计费秒的价格，并非整段视频的固定打包价格。

  • 扣费保障：任务失败按原扣费全额退回。
  • 免费查询：查询状态与下载视频不会重复扣费。

模型对比与定价

参考网站模型广场

注：参考视频时长由服务端读取，客户端自填估计值无法改变扣费。

调用代码示例

1. 创建文生视频任务

1
2
3
4
5
6
7
8
9
10
11
curl https://api.api2cn.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.0",
    "prompt": "蓝色陶瓷球的产品特写，镜头缓慢环绕，光线自然",
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p"
  }'

2. 上传参考素材

每次仅能上传一个文件，kind 可选用 image、video 或 audio。

  • 文件规格限制：

  • 图片：支持 PNG / JPEG / WebP，单张最大 20MB

  • 音频：单文件最大 20MB

  • 视频：单文件最大 64MB

  • 链接时效：返回的授权链接有效期为 24 小时，请勿公开转发，并在过期前提交任务。

1
2
3
4
5
curl https://api.api2cn.com/v1/video-assets \
  -H "Authorization: Bearer $API_KEY" \
  -F "kind=video" \
  -F "[email protected]"

3. 创建全能参考任务

将素材上传接口返回的链接填入 referenceImages、referenceVideos、referenceAudios 数组中（也支持其他可公开读取的 HTTPS 地址，不支持本地路径或 blob 链接）。提示词中可使用 @图1、@视频1、@音频1 引用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
curl https://api.api2cn.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.5",
    "prompt": "画面主体参考@图1，运镜参考@视频1，节奏参考@音频1",
    "ratio": "16:9",
    "duration": 5,
    "resolution": "480p",
    "referenceImages": ["YOUR_UPLOADED_IMAGE_HTTPS_URL"],
    "referenceVideos": ["YOUR_UPLOADED_VIDEO_HTTPS_URL"],
    "referenceAudios": ["YOUR_UPLOADED_AUDIO_HTTPS_URL"]
  }'

📌 细节说明：

  • 画面比例 (ratio)：支持 21:9、16:9、4:3、1:1、3:4、9:16、Auto。
  • 首尾帧模式：使用 first_image，可选 last_image，并配合 ratio=Auto（不要与全能参考数组混用）。

4. 查询状态与下载视频

获取 task_id 后建议每 3–5 秒查询一次状态。取得 task_id 后应轮询查询原任务，请勿重复创建。其他用户无法使用其自己的密钥查询或下载你的任务。

  • queued / in_progress：处理中，请继续等待
  • completed：任务完成，可以发起下载
  • failed：任务失败，可查看错误和退款记录
1
2
3
4
5
6
7
8
9
# 查询任务状态（将 task_xxx 替换为实际返回的 task_id）
curl https://api.api2cn.com/v1/videos/task_xxx \
  -H "Authorization: Bearer $API_KEY"

# 状态变为 completed 后下载视频
curl -fL https://api.api2cn.com/v1/videos/task_xxx/content \
  -H "Authorization: Bearer $API_KEY" \
  -o result.mp4