Skip to content

video-unified.md

Latest commit

 

History

History
263 lines (206 loc) · 6.73 KB

video-unified.md

File metadata and controls

263 lines (206 loc) · 6.73 KB

视频统一格式 API

来源：云雾 API（OneAPI 格式）

适用模型：Veo、即梦、Sora、Grok Video

接口列表

操作 端点 方法
创建视频 /v1/video/create POST
查询任务 /v1/video/query GET

创建视频

请求

POST https://yunwu.ai/v1/video/create
Authorization: Bearer <token>
Content-Type: application/json

通用请求参数

参数 类型 必填 说明
model string 是 模型名称（见各模型参数）
prompt string 是 提示词
aspect_ratio string 否 宽高比
images string[] 否 参考图 URL 数组

Veo 参数

请求示例

{
    "model": "veo3.1-fast",
    "prompt": "A cat playing with a ball",
    "aspect_ratio": "16:9",
    "images": ["https://example.com/image.png"],
    "enhance_prompt": true,
    "enable_upsample": true
}

参数说明

参数 类型 必填 说明
model string 是 见下方模型列表
prompt string 是 提示词
aspect_ratio string 否 16:9 或 9:16（仅 veo3 支持）
images string[] 否 参考图 URL，不同模型支持数量不同
enhance_prompt boolean 否 自动将中文转英文提示词
enable_upsample boolean 否 启用超分

模型列表

模型 特性
veo2、veo2-fast 基础文生视频
veo2-fast-frames 支持首尾帧（最多 2 张图）
veo2-fast-components 支持素材合成（最多 3 张图）
veo2-pro、veo2-pro-components 高质量版本
veo3、veo3-fast 支持音频生成
veo3-frames、veo3-fast-frames 支持首帧
veo3-pro、veo3-pro-frames 高质量+首帧
veo3.1、veo3.1-fast、veo3.1-pro 最新版本，自适应首帧
veo3.1-components 支持素材合成（最多 3 张图）

状态码

// Veo 任务状态常量
const (
    VeoStatusPending                  = "pending"
    VeoStatusImageDownloading         = "image_downloading"
    VeoStatusVideoGenerating          = "video_generating"
    VeoStatusVideoGenerationCompleted = "video_generation_completed"
    VeoStatusVideoGenerationFailed    = "video_generation_failed"
    VeoStatusVideoUpsampling          = "video_upsampling"
    VeoStatusVideoUpsamplingCompleted = "video_upsampling_completed"
    VeoStatusVideoUpsamplingFailed    = "video_upsampling_failed"
    VeoStatusCompleted                = "completed"
    VeoStatusFailed                   = "failed"
    VeoStatusError                    = "error"
)

即梦参数

请求示例

{
    "model": "jimeng-video-3.0",
    "prompt": "cat fish",
    "aspect_ratio": "16:9",
    "size": "1080P",
    "images": []
}

参数说明

参数 类型 必填 说明
model string 是 jimeng-video-3.0
prompt string 是 提示词
aspect_ratio string 否 16:9、9:16、4:3、3:4、1:1、21:9
size string 否 720x1280、1280x720、1080P
images string[] 否 参考图 URL 数组（图生视频）

状态码（视频统一格式）

视频统一格式下使用通用状态码：pending、processing、success、failed

状态码（官方格式）

// 即梦任务状态常量
const (
    JimengV3StatusNotStart   = "NOT_START"
    JimengV3StatusSubmitted  = "SUBMITTED"
    JimengV3StatusQueued     = "QUEUED"
    JimengV3StatusInProgress = "IN_PROGRESS"
    JimengV3StatusFailure    = "FAILURE"
    JimengV3StatusSuccess    = "SUCCESS"
)

Sora 参数

请求示例

{
    "model": "sora-2",
    "prompt": "make animate",
    "orientation": "portrait",
    "size": "large",
    "duration": 15,
    "images": [],
    "watermark": false,
    "private": true
}

参数说明

参数 类型 必填 说明
model string 是 sora-2、sora-2-pro
prompt string 是 提示词
orientation string 否 portrait（竖屏）、landscape（横屏）
size string 否 small（一般 720p）、large
duration integer 否 视频时长（支持 10、15 等）
images string[] 否 参考图 URL 数组
watermark boolean 否 是否添加水印（默认 true）
private boolean 否 是否隐藏视频（默认 false）

模型列表

模型 特性
sora-2 基础文生视频
sora-2-pro 高质量版本

Grok Video 参数

请求示例

{
    "model": "grok-video-3",
    "prompt": "小猫在吃鱼 --mode=custom",
    "aspect_ratio": "3:2",
    "size": "720P",
    "images": ["https://example.com/image.png"]
}

参数说明

参数 类型 必填 说明
model string 是 grok-video-3
prompt string 是 提示词（支持 --mode=custom 参数）
aspect_ratio string 否 2:3、3:2、1:1
size string 否 720P（暂只支持 720P）
images string[] 否 参考图 URL 数组

响应格式

创建响应

{
    "id": "jimeng:7391ad0e-9813-48ba-a742-ed0720e44e45",
    "status": "pending",
    "status_update_time": 1762241017286
}
字段 类型 说明
id string 任务 ID（用于查询，格式可能带模型前缀如 jimeng:、veo3.1-components:）
status string 任务状态
status_update_time number 状态更新时间戳（毫秒）

查询请求

GET https://yunwu.ai/v1/video/query?id={task_id}
Authorization: Bearer <token>

查询响应

{
    "id": "033fa60e-f37c-4ff6-a44d-5585ffea938d",
    "status": "success",
    "video_url": "https://...",
    "enhanced_prompt": "增强后的英文提示词",
    "status_update_time": 1750323167003
}
字段 类型 说明
id string 任务 ID（注意：可能与创建时返回的不同）
status string 任务状态
video_url string 生成的视频 URL（成功时返回）
enhanced_prompt string 增强后的提示词（Veo 使用 enhance_prompt 时返回）
status_update_time number 状态更新时间戳（毫秒）

重要： 查询时必须使用创建接口返回的完整 ID（如 jimeng:7391ad0e-...），查询响应中的 id 可能不带前缀，实现时应忽略响应中的 id。

通用状态码

视频统一格式归一化后的状态：

状态 说明
pending 任务已创建，等待处理
processing 任务处理中
success 任务成功，video_url 可用
failed 任务失败