统一视频生成

使用统一接口提交文生视频或图生视频任务。Grok、Veo 3.1、Sora 2 和 Seedance 使用相同的提交与查询流程。

视频生成是异步任务。提交成功后保存 task_id，再通过 GET /v1/tasks/{task_id} 查询状态和结果。

支持模型

模型	说明
`grok-imagine-video-1.5`	Grok 文生视频与单图生视频
`veo-3.1-flash`	Veo 3.1 快速视频生成
`veo-3.1-pro`	Veo 3.1 高质量视频生成
`sora-2`	Sora 2 标准视频生成
`seedance-1.0-fast`	Seedance 1.0 快速视频生成
`seedance-1.0-mini`	Seedance 1.0 Mini 视频生成
`seedance-1.0-pro`	Seedance 1.0 Pro 视频生成
`seedance-1.5-pro`	Seedance 1.5 Pro 视频生成
`seedance-2.0`	Seedance 2.0 视频生成
`seedance-2.0-fast`	Seedance 2.0 快速视频生成

模型的实时可用性取决于当前渠道，请以模型广场为准。

请求参数

model

string

required

视频模型 ID。填写上表中的一个公开模型 ID。

prompt

string

required

视频内容、动作、镜头和风格描述。

image

string

单张参考图片 URL 或 Base64 图片数据。传入后，任务按图生视频处理。

images

array<string>

参考图片数组。Veo 3.1 当前使用第一张图片；Seedance 建议使用该字段传入图生视频参考图。各模型支持的图片数量以当前渠道为准。

seconds

string

视频时长，单位为秒。Seedance 请优先使用整数类型的 duration，以兼容全部渠道。

size

string

输出尺寸，例如 1280x720 或 720x1280。

aspect_ratio

string

输出比例，例如 16:9 或 9:16。

resolution

string

输出分辨率档位，例如 720p、1080p 或 4k。实际支持范围取决于模型。

metadata

object

模型扩展参数。Veo 支持 durationSeconds、aspectRatio、resolution、negativePrompt、personGeneration、seed 和 generateAudio。

模型参数差异

模型	时长	画面与分辨率	参考输入
`sora-2`	`8` 或 `12` 秒，默认 `8`	`1280x720` 或 `720x1280`，仅 720p	支持参考图片，不支持参考视频或音频
Veo 3.1	默认 `8` 秒	使用 `metadata.aspectRatio` 和 `metadata.resolution` 控制；支持范围由上游渠道决定	支持单张参考图片
Grok	由当前渠道决定	使用 `size` 或 `aspect_ratio`	支持单张或多张参考图片字段
Seedance 1.0	`10` 秒可选择对应的 10 秒模型变体；其他时长由渠道决定	使用 `aspect_ratio` 和 `resolution`	支持参考图片，数量限制由渠道决定
`seedance-1.5-pro`	`10` 或 `12` 秒可选择对应时长变体	使用 `aspect_ratio` 和 `resolution`	支持参考图片，数量限制由渠道决定
Seedance 2.0	由当前渠道决定；部分渠道支持 `4` 到 `15` 秒并默认 `5` 秒	使用 `aspect_ratio` 和 `resolution`	支持参考图片，数量限制由渠道决定

sora-2 的 seconds 只接受 8 或 12。其他值会在路由阶段被拒绝。

文生视频示例

curl --request POST 'https://xcompute.us/v1/video/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "清晨的海边公路，一辆复古汽车驶过，电影感跟拍镜头",
    "seconds": "8",
    "size": "1280x720"
  }'

图生视频示例

curl --request POST 'https://xcompute.us/v1/video/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-video-1.5",
    "prompt": "保持主体外观一致，人物缓慢转头看向窗外",
    "image": "https://example.com/input.png",
    "seconds": "8",
    "aspect_ratio": "16:9"
  }'

Veo 3.1 示例

curl --request POST 'https://xcompute.us/v1/video/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo-3.1-flash",
    "prompt": "雨夜城市街道，镜头贴近地面向前推进，写实电影质感",
    "metadata": {
      "durationSeconds": 8,
      "aspectRatio": "16:9",
      "resolution": "1080p",
      "generateAudio": true
    }
  }'

Seedance 示例

Seedance 建议使用 duration 和 images，这组字段可以覆盖当前接入的不同 Seedance 渠道。

curl --request POST 'https://xcompute.us/v1/video/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.0",
    "prompt": "保持人物外观一致，镜头在日出时缓慢环绕主体",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "images": [
      "https://example.com/reference.jpg"
    ]
  }'

Seedance 渠道还可以通过 metadata 传递 generate_audio、return_last_frame、camera_fixed、seed 和 watermark 等扩展字段。字段是否生效取决于具体模型和当前渠道。

提交响应

{
  "status": "queued",
  "task_id": "task_01KXXXXXXXXXXXXXXXXXXXX",
  "progress": "0%",
  "code": "success"
}

查询任务

curl --request GET \
  --url 'https://xcompute.us/v1/tasks/task_01KXXXXXXXXXXXXXXXXXXXX' \
  --header 'Authorization: Bearer YOUR_API_KEY'

任务状态包括 queued、in_progress、completed 和 failed。任务完成后，响应中的结果 URL 字段包含生成的视频地址。

任务查询

查看统一异步任务状态与结果字段。

OpenAI 兼容入口

需要使用 OpenAI Videos API 路径时，也可以将同一请求发送到 POST /v1/videos，并通过 GET /v1/videos/{task_id} 查询。新接入建议使用本页的统一接口和统一任务查询流程。

​支持模型

​请求参数

​模型参数差异

​文生视频示例

​图生视频示例

​Veo 3.1 示例

​Seedance 示例

​提交响应

​查询任务

任务查询

​OpenAI 兼容入口

支持模型

请求参数

模型参数差异

文生视频示例

图生视频示例

Veo 3.1 示例

Seedance 示例

提交响应

查询任务

OpenAI 兼容入口