统一视频生成

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"
  }'

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

POST

https://xcompute.us

video

generations

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"
  }'

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

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

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

支持模型

模型	说明
`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 快速视频生成

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

请求参数

string

required

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

string

required

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

string

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

array<string>

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

string

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

string

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

string

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

string

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

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` 控制；支持范围由上游渠道决定	支持单张参考图片
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"
  }'

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} 查询。该入口使用 multipart/form-data，与本页的统一 JSON 请求格式不同。

Grok Imagine 1.5 视频生成

查看 Grok 的 multipart 参数、任务查询、视频下载、参考图限制和完整示例。

文本生成

图像生成与编辑

语音生成

视频生成

可灵视频

可灵数字人

可灵音频

可灵图像

可灵通用

任务管理

统一视频生成

支持模型

请求参数

模型参数差异

文生视频示例

Veo 3.1 示例

Seedance 示例

提交响应

查询任务

任务查询

OpenAI 兼容入口

Grok Imagine 1.5 视频生成

​支持模型

​请求参数

​模型参数差异

​文生视频示例

​Veo 3.1 示例

​Seedance 示例

​提交响应

​查询任务

任务查询

​OpenAI 兼容入口

Grok Imagine 1.5 视频生成

支持模型

请求参数

模型参数差异

文生视频示例

Veo 3.1 示例

Seedance 示例

提交响应

查询任务

OpenAI 兼容入口