创建视频生成任务

正式环境

https://api.302.ai

POST

/302/v2/video/create

模型列表与各模型支持的功能请参考文档：
https://kdocs.cn/l/csVggsGSdgkp

为获取最新模型与能力信息，请优先使用接口：获取视频模型信息列表。

模型名称兼容规则

分隔符兼容：模型名支持使用 -（中划线）或 _（下划线）。

大小写不敏感：传入模型名不区分大小写。

兼容旧版命名：仍兼容旧版模型命名风格。

后缀兼容：支持在模型名后追加以下后缀（用于旧调用习惯兼容）：
-t2v / -i2v / -v2v
即使继续使用旧名称，也不会报错。

任务类型识别逻辑（无需强制依赖模型后缀）

服务端会根据请求参数自动判断生成类型：

若包含 image / end_image 字段：判定为图片生成视频（I2V）

若包含 video 字段：判定为视频生成视频（V2V）

其他情况：通常判定为文生视频（T2V）（以实际接口规则为准）

Webhook 回调支持

支持配置 webhook，在视频任务成功 / 失败时推送结果。

若在后台自动轮询任务期间因 API Key 不可用导致任务查询失败：

webhook 仍会推送失败状态结果；

当 API Key 恢复可用后，你仍可手动调用任务查询接口继续获取任务结果。

请求 Content-Type 支持

接口请求支持以下两种 Content-Type：

application/json

multipart/form-data

媒体参数传递方式说明

图片（image / end_image）

支持以下形式传参：

Base64 图片

公网可访问的图片 URL

文件流（multipart 上传）

视频（video）

由于请求参数大小限制：

仅支持使用 URL 链接形式传参

不支持 base64 / 文件流直传视频

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "model": "string",
    "prompt": "string",
    "image": "string",
    "end_image": "string",
    "video": "string",
    "negative_prompt": "string",
    "duration": 0,
    "resolution": "string",
    "aspect_ratio": "string",
    "fps": "string",
    "其他模型额外支持的字段具体见文档说明 ": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/302/v2/video/create?webhook' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "prompt": "string",
    "image": "string",
    "end_image": "string",
    "video": "string",
    "negative_prompt": "string",
    "duration": 0,
    "resolution": "string",
    "aspect_ratio": "string",
    "fps": "string",
    "其他模型额外支持的字段具体见文档说明 ": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "task_id": "301504317665393",
    "status": "pending",
    "created_at": "2025-08-14T09:34:45.529818Z"
}

修改于 2026-02-05 20:01:37

Chat（UniFuncs深度调研）

获取视频任务信息

创建视频生成任务

模型名称兼容规则#

任务类型识别逻辑（无需强制依赖模型后缀）#

Webhook 回调支持#

请求 Content-Type 支持#

媒体参数传递方式说明#

图片（image / end_image）#

视频（video）#