⌘K

Kirin V3 Turbo - Text to Video

kirin_v3_turbo_t2v

Kirin V3 Turbo 文生视频接口，支持 720P 到 4K 视频输出、3 到 15 秒视频时长、文生视频宽高比、音频生成、提示词增强和主体参考。

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID。

值：kirin_v3_turbo_t2v

prompt string 必填

视频生成提示词，可以在同一提示词中包含正向和负向描述。

resolution string

视频输出分辨率。

选项：720P、1080P、2K、4K

默认值：720P

duration string

生成视频时长，单位为秒。

选项：3、4、5、6、7、8、9、10、11、12、13、14、15

默认值：5

aspect_ratio string

视频宽高比。

选项：16:9、9:16、1:1

默认值：16:9

sound string

是否随视频生成音频。

选项：on、off

默认值：off

enhance_prompt boolean | string

是否启用提示词增强。

选项：true、false、on、off、enabled、disabled

element_list array

主体参考列表，通过主体库中的主体 ID 配置主体参考。

创建主体请参考：kirin_custom_elements

"element_list": [
  {
    "element_id": 123456
  }
]

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息。仅在状态为 failed 时出现。

code string

错误码。

error_message string

详细错误信息。

output array

生成结果。仅在状态为 completed 时出现。

content array

生成内容列表。

type string

资源类型。

值：video

url string

生成视频 URL。

duration number

生成视频时长，单位为秒。

jobId string

远端任务 ID。

usage object

用量统计。仅在状态为 completed 时出现。

metadata object

元数据信息。

错误码

错误码描述
002011095内部生成错误
002011096结果解析错误
002011097HTTP 错误响应