视频生成

支持文生视频与图生视频。由于渲染需要数分钟,视频生成是一个异步任务:提交提示词后会收到一个 task_id,轮询至任务完成,然后下载 MP4。可用模型包括 grok-imagine-video、grok-imagine-video-1.5,以及多媒体分组的 Seedance / Wan 3.0 / Berry / MiniMax H3 等(见下文)—— 完整列表与价格请查看模型广场。

三步流程

1. POST 提交任务 → 获得 task_id。2. GET 轮询任务直到 status 变为 SUCCESS → 读取 result_url。3. GET 内容地址 → 下载 video/mp4。

第 1 步 · 提交任务

POST https://cn.chatapi.app/v1/video/generations
curl https://cn.chatapi.app/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "A golden retriever puppy running on grass, 4 seconds"
  }'
import requests

base = "https://cn.chatapi.app"
key  = "sk-xxxxxxxx"
headers = {"Authorization": f"Bearer {key}"}

resp = requests.post(
    f"{base}/v1/video/generations",
    headers=headers,
    json={
        "model": "grok-imagine-video",
        "prompt": "A golden retriever puppy running on grass, 4 seconds",
    },
)
task_id = resp.json()["task_id"]
print(task_id)

响应会立即返回一个已排队的任务:

{
  "id": "task_UrufFh4Ww57Q6XWZ7trGZJajiHGw88Md",
  "task_id": "task_UrufFh4Ww57Q6XWZ7trGZJajiHGw88Md",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "queued",
  "progress": 0
}

请求参数

参数类型说明
modelstring必填。视频模型名称,例如 grok-imagine-video
promptstring必填。视频的文字描述
imagestring可选。用于图生视频的图片 URL 或 base64(取决于模型)

第 2 步 · 轮询状态

GET https://cn.chatapi.app/v1/video/generations/{task_id}

建议每 5–10 秒轮询一次。status 会依次经过 queued → IN_PROGRESS → SUCCESS(或 FAILURE)。当变为 SUCCESS 时,响应中会携带 result_url。

curl https://cn.chatapi.app/v1/video/generations/task_UrufFh4Ww57Q6XWZ7trGZJajiHGw88Md \
  -H "Authorization: Bearer sk-xxxxxxxx"

完成后的响应(已省略部分字段):

{
  "code": "success",
  "data": {
    "task_id": "task_UrufFh4Ww57Q6XWZ7trGZJajiHGw88Md",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://cn.chatapi.app/v1/videos/task_UrufFh4Ww57Q6XWZ7trGZJajiHGw88Md/content"
  }
}

第 3 步 · 下载视频

GET https://cn.chatapi.app/v1/videos/{task_id}/content

请求 result_url(或根据 task_id 拼出内容地址),即可下载渲染完成的 video/mp4。

curl -L https://cn.chatapi.app/v1/videos/task_UrufFh4Ww57Q6XWZ7trGZJajiHGw88Md/content \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -o output.mp4

完整 Python 示例

import time, requests

base = "https://cn.chatapi.app"
headers = {"Authorization": "Bearer sk-xxxxxxxx"}

# 1. 提交任务
task_id = requests.post(
    f"{base}/v1/video/generations", headers=headers,
    json={"model": "grok-imagine-video",
          "prompt": "A puppy running on grass, 4 seconds"},
).json()["task_id"]

# 2. 轮询状态
while True:
    data = requests.get(f"{base}/v1/video/generations/{task_id}", headers=headers).json()["data"]
    if data["status"] == "SUCCESS":
        break
    if data["status"] == "FAILURE":
        raise RuntimeError(data.get("fail_reason"))
    time.sleep(8)

# 3. 下载视频
mp4 = requests.get(data["result_url"], headers=headers).content
open("output.mp4", "wb").write(mp4)

多媒体视频模型(未审查)

第三方未审查号池(支持 NSFW、严禁未成年内容),「按厂家」路由选「多媒体」或「全部模型与厂家」的 Key 均可调用。走 OpenAI Video API:POST /v1/videos 提交 → GET /v1/videos/{id} 轮询到 completed → GET /v1/videos/{id}/content 下载 MP4(成片保留 7 天)。一般 1–5 分钟。按秒计费,价格随分辨率变化,低于单次最低价按最低价收。同一系列的不同模式是不同的模型名(如 seedance-2.0-text-to-video / seedance-2.0-image-to-video)。

模型 / 模式时长价格(美元/秒,按分辨率)单次最低
berry-1.0-image-to-video
图生视频 · 需首帧图 image
2–30 秒480p $0.096 · 720p $0.192 · 1080p $0.384$0.192
berry-1.0-pro-image-to-video
图生视频 · 需首帧图 image
2–30 秒1080p $0.346 · 2k $0.384 · 4k $0.442$0.691
berry-1.0-pro-reference-to-video
参考生视频
2–30 秒1080p $0.346 · 2k $0.384 · 4k $0.442$0.691
berry-1.0-pro-text-to-video
文生视频
2–30 秒1080p $0.346 · 2k $0.384 · 4k $0.442$0.691
berry-1.0-pro-turbo-image-to-video
图生视频 · 需首帧图 image
2–30 秒1080p $0.499 · 2k $0.538 · 4k $0.595$0.998
berry-1.0-pro-turbo-reference-to-video
参考生视频
2–30 秒1080p $0.499 · 2k $0.538 · 4k $0.595$0.998
berry-1.0-pro-turbo-text-to-video
文生视频
2–30 秒1080p $0.499 · 2k $0.538 · 4k $0.595$0.998
berry-1.0-reference-to-video
参考生视频
2–30 秒480p $0.096 · 720p $0.192 · 1080p $0.384$0.192
berry-1.0-text-to-video
文生视频
2–30 秒480p $0.096 · 720p $0.192 · 1080p $0.384$0.192
berry-1.0-turbo-image-to-video
图生视频 · 需首帧图 image
2–30 秒480p $0.131 · 720p $0.269 · 1080p $0.538$0.261
berry-1.0-turbo-reference-to-video
参考生视频
2–30 秒480p $0.131 · 720p $0.269 · 1080p $0.538$0.261
berry-1.0-turbo-text-to-video
文生视频
2–30 秒480p $0.131 · 720p $0.269 · 1080p $0.538$0.261
minimax-h35–15 秒480p $0.026 · 768p $0.038 · 1080p $0.051 · 2k $0.064 · 4k $0.128$0.128
seedance-2.0-fast-image-to-video
图生视频 · 需首帧图 image
4–15 秒480p $0.068 · 720p $0.145$0.271
seedance-2.0-fast-reference-to-video
参考生视频
4–15 秒480p $0.068 · 720p $0.145$0.271
seedance-2.0-fast-text-to-video
文生视频
4–15 秒480p $0.068 · 720p $0.145$0.271
seedance-2.0-image-to-video
图生视频 · 需首帧图 image
4–15 秒480p $0.179 · 720p $0.389 · 1080p $0.957$0.717
seedance-2.0-mini-image-to-video
图生视频 · 需首帧图 image
4–15 秒480p $0.038 · 720p $0.077$0.154
seedance-2.0-mini-reference-to-video
参考生视频
4–15 秒480p $0.038 · 720p $0.077$0.154
seedance-2.0-mini-text-to-video
文生视频
4–15 秒480p $0.038 · 720p $0.077$0.154
seedance-2.0-reference-to-video
参考生视频
4–15 秒480p $0.179 · 720p $0.389 · 1080p $0.957$0.717
seedance-2.0-text-to-video
文生视频
4–15 秒480p $0.179 · 720p $0.389 · 1080p $0.957$0.717
seedance-2.5-draft-to-video
草稿转成片 · 需草稿任务 metadata.draft_task_id
按参考视频1080p $1.456$5.822
seedance-2.5-image-to-video
图生视频 · 需首帧图 image
4–30 秒480p $0.263 · 720p $0.592 · 1080p $1.456$1.053
seedance-2.5-reference-to-video
参考生视频
4–30 秒480p $0.263 · 720p $0.592 · 1080p $1.456$1.053
seedance-2.5-text-to-video
文生视频
4–30 秒480p $0.263 · 720p $0.592 · 1080p $1.456$1.053
seedance-2.5-video-to-video
视频改视频 · 需参考视频 metadata.reference_video_urls
按参考视频480p $0.263 · 720p $0.592 · 1080p $1.456$1.053
w3.0-image-to-video
图生视频 · 需首帧图 image
2–30 秒480p $0.096 · 720p $0.192 · 1080p $0.384$0.192
w3.0-prime-image-to-video
图生视频 · 需首帧图 image
2–30 秒480p $0.131 · 720p $0.269 · 1080p $0.538$0.261
w3.0-prime-pro-image-to-video
图生视频 · 需首帧图 image
2–30 秒1080p $0.499 · 2k $0.538 · 4k $0.595$0.998
w3.0-prime-pro-reference-to-video
参考生视频
2–30 秒1080p $0.499 · 2k $0.538 · 4k $0.595$0.998
w3.0-prime-pro-text-to-video
文生视频
2–30 秒1080p $0.499 · 2k $0.538 · 4k $0.595$0.998
w3.0-prime-reference-to-video
参考生视频
2–30 秒480p $0.131 · 720p $0.269 · 1080p $0.538$0.261
w3.0-prime-text-to-video
文生视频
2–30 秒480p $0.131 · 720p $0.269 · 1080p $0.538$0.261
w3.0-pro-image-to-video
图生视频 · 需首帧图 image
2–30 秒1080p $0.346 · 2k $0.384 · 4k $0.442$0.691
w3.0-pro-reference-to-video
参考生视频
2–30 秒1080p $0.346 · 2k $0.384 · 4k $0.442$0.691
w3.0-pro-text-to-video
文生视频
2–30 秒1080p $0.346 · 2k $0.384 · 4k $0.442$0.691
w3.0-reference-to-video
参考生视频
2–30 秒480p $0.096 · 720p $0.192 · 1080p $0.384$0.192
w3.0-text-to-video
文生视频
2–30 秒480p $0.096 · 720p $0.192 · 1080p $0.384$0.192
wan-2.2
需首帧图 image
5–8 秒480p $0.102 · 720p $0.205$0.512
wan-2.7
需首帧图 image
2–15 秒720p $0.333 · 1080p $0.512$0.666
wan-animate
需首帧图 image、驱动视频 metadata.video_url
按参考视频480p $0.102 · 720p $0.211$0.102
curl https://cn.chatapi.app/v1/videos \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0-mini-text-to-video","prompt":"a paper boat drifting on a rainy street","seconds":"5","size":"480p","metadata":{"ratio":"16:9"}}'
# → {"id":"task_xxx","status":"queued",...};轮询 GET /v1/videos/task_xxx,completed 后下载 /v1/videos/task_xxx/content
参数

seconds 时长(按模型范围自动钳制);size 分辨率档(如 480p / 720p / 1080p / 2k / 4k,也接受 1280x720,不传为最低档);image 首帧图(图生视频)、images 参考图(参考生视频),支持 https URL 或 base64 data URI。metadata 可选:ratio 宽高比、seed、last_frame_url 尾帧、reference_video_urls / reference_audio_urls、generate_audio。

音轨默认关闭

支持音轨的模型默认 generate_audio=false。显式开启后会对生成的音轨做内容审核,尺度大的内容可能整单失败(自动退款)。

计费说明

视频模型均按秒计费:grok-imagine-video 系列按分辨率每秒计价;多媒体分组按分辨率每秒计价并有单次最低价。当前价格请查看模型广场。

全部文档