视频生成

Video Generation

POST /v1/contents/generations/tasks —— 提交文生视频任务

视频生成为异步任务，协议与火山引擎 Ark（Seedance）兼容：本接口提交后立即返回任务 ID（状态为 queued），随后通过视频任务查询 GET /v1/contents/generations/tasks/{id} 轮询获取成品视频。

当前视频模型为 grok-imagine-video（xAI Grok Imagine，图生视频）：content 中需同时提供一段 text 提示词和一张 image_url 参考图；video_url / audio_url / generate_audio / watermark 会被该模型忽略。可用模型以 GET /v1/models 返回为准。

提交视频生成任务。视频耗时较长，接口立即返回 task_id，再用查询接口轮询。

POSThttps://coder.api.visioncoder.cn/v1/contents/generations/tasks

鉴权

Authorization: Bearer YOUR_API_KEY

请求参数

参数	类型	必填	说明
`model`	string	是	视频模型 ID，当前是 `grok-imagine-video`
`content`	array	是	多模态内容块。`grok-imagine-video` 需要同时给一段 `text` 和一张 `image_url`
`ratio`	string	否	输出画面比例
`duration`	integer	否	时长秒数，1–60。填 `-1` 或不填则由模型决定
`generate_audio`	boolean	否	是否生成音频。`grok-imagine-video` 会忽略
`watermark`	boolean	否	是否加水印。`grok-imagine-video` 会忽略

调用示例

curl https://coder.api.visioncoder.cn/v1/contents/generations/tasks \
  -H "Authorization: Bearer $VISIONCODER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "content": [
      {
        "type": "text",
        "text": "一艘帆船驶过晨雾中的湖面，电影感运镜"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/reference.png" }
      }
    ],
    "ratio": "16:9",
    "duration": 5
  }'

import requests

resp = requests.post(
    "https://coder.api.visioncoder.cn/v1/contents/generations/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "grok-imagine-video",
        "content": [
            {"type": "text", "text": "一艘帆船驶过晨雾中的湖面，电影感运镜"},
            {"type": "image_url", "image_url": {"url": "https://example.com/reference.png"}},
        ],
        "ratio": "16:9",
        "duration": 5,
    },
)
task_id = resp.json()["id"]
print(task_id)

const resp = await fetch("https://coder.api.visioncoder.cn/v1/contents/generations/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VISIONCODER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-video",
    content: [
      { type: "text", text: "一艘帆船驶过晨雾中的湖面，电影感运镜" },
      { type: "image_url", image_url: { url: "https://example.com/reference.png" } },
    ],
    ratio: "16:9",
    duration: 5,
  }),
});
const task = await resp.json();
console.log(task.id);

参数说明：

ratio：16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive。
duration：视频时长（秒），范围 1-60；传 -1 或不传由模型自行决定。

使用参考媒体

content 支持文本、图片、视频和音频。传入参考媒体时，请使用与 type 对应的 URL 字段和 role。

{
  "model": "grok-imagine-video",
  "content": [
    {
      "type": "text",
      "text": "让画面中的云层缓慢移动，镜头向前推进"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference.png"
      },
      "role": "reference_image"
    }
  ],
  "ratio": "16:9",
  "duration": 5
}

可用的内容类型如下：

`type`	内容字段	`role`
`text`	`text`	不需要
`image_url`	`image_url.url`	`reference_image`
`video_url`	`video_url.url`	`reference_video`
`audio_url`	`audio_url.url`	`reference_audio`

响应示例

{
  "id": "cgt-01HZY3K8Q2W7X9V4",
  "model": "grok-imagine-video",
  "status": "queued",
  "created_at": 1779438767,
  "updated_at": 1779438767
}

加群 & 客服