文生视频
POST
/openapi/v2/video/text/generate
文生视频
能力示例视频
适用场景
| 场景 | 说明 |
|---|---|
| 创意短片 | 用文字描述角色、场景、镜头、动作和风格 |
| 营销素材 | 快速生成商品、活动、社媒短视频素材 |
| 多版本探索 | 通过修改 prompt、seed、画幅快速产出多个方向 |
接入流程
准备 API Key -> 选择模型和参数 -> 发起文生视频任务 -> 查询任务状态或等待 Webhook 回调 -> 获取视频 URL接口地址
请求参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称：c1、v6、v5.6、v5新接入优先使用 c1 或 v6 |
prompt | string | 是 | 提示词，最长 5000 characters （约等于 5000 个字母/汉字） |
duration | integer | 是 | 视频时长：c1 / v6 支持 1~15 秒；v5.6 支持 5 / 8 / 10 秒；v5 支持 5 / 8 秒。 |
quality | string | 是 | 分辨率：360p、540p、720p、1080p |
aspect_ratio | string | 是 | 画幅比例 c1 / v6 支持 16:9、9:16、4:3、3:4、1:1、2:3、3:2、21:9v5.6 / v5 支持 16:9、9:16、4:3、3:4、1:1。 |
seed | integer | 否 | 随机种子，范围 0-2147483647 |
generate_audio_switch | boolean | 否 | 是否生成音频；c1、v6、v5.6 支持，v5 使用旧版音效字段。 |
generate_multi_clip_switch | boolean | 否 | 是否生成多镜头；v6 支持开关，c1 可通过提示词分镜，v5.6 / v5 不支持。 |
sound_effect_switch | boolean | 否 | 旧版音效开关，默认 false。新接入建议使用 generate_audio_switch 或独立的「音效生成 Sound Effect」接口。 |
sound_effect_content | string | 否 | 音效描述；为空时可根据视频内容生成 |
lip_sync_switch | boolean | 否 | 是否启用对口型；v5 旧版字段。新接入建议使用独立「对口型 Lipsync」接口。 |
lip_sync_tts_content | string | 否 | TTS 文本，约 140 characters；v5 旧版字段。 |
lip_sync_tts_speaker_id | string | 否 | TTS 音色 ID，需通过音色接口获取；v5 旧版字段。 |
最小请求示例
{
"aspect_ratio": "16:9",
"duration": 5,
"model": "v6",
"prompt": "A cinematic shot of a city street at night",
"quality": "720p"
}常用参数组合
| 目标 | 推荐设置 |
|---|---|
| 接入测试 | model=v6，duration=5，quality=540p |
| 更强电影质感或复杂动作 | model=c1，根据预算选择 720p 或 1080p |
| 需要同步生成音频 | generate_audio_switch=true，模型使用 c1、v6 |
字段填写备注
| 字段类型 | 填写建议 |
|---|---|
API-KEY | 使用正式 API Key，不要放在 URL Query 中。 |
Ai-trace-id | 每次请求使用新的 UUID；同一个值重复请求可能被识别为重复任务。 |
Content-Type | application/json |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
Resp.video_id | integer | 视频任务 ID |
Resp.credits | integer | 本次任务消耗点数 |
响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"video_id": 123456,
"credits": 60
}
}下一步
video_id 获取生成结果。注意事项
Ai-trace-id 每次请求建议唯一，用于排查和幂等控制。c1 / v6 支持 1~15 秒；v5.6 支持 5 / 8 / 10 秒；v5 支持 5 / 8 秒。请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
curl --location 'https://app-api.pixverseai.cn/openapi/v2/video/text/generate' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
"model": "v6",
"prompt": "A cinematic scene with natural motion",
"duration": 5,
"quality": "720p",
"seed": 0,
"webhook_id": "your-webhook-id",
"aspect_ratio": "16:9",
"template_id": 401816138568512,
"generate_audio_switch": false,
"generate_multi_clip_switch": false,
"sound_effect_switch": false,
"sound_effect_content": "Soft ambient wind",
"lip_sync_switch": false,
"lip_sync_tts_content": "欢迎使用 PixVerse API",
"lip_sync_tts_speaker_id": "Auto"
}'响应示例响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"video_id": 123456789
}
}修改于 2026-09-04 06:46:31