任务:文生视频
概览
- 请求方法:
POST - 路径:
/kling/v1/videos/text2video - 内容类型:
application/json
认证方式
- HTTP Bearer:
Authorization: Bearer <token>
请求参数
Body 参数(JSON)
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 是 | 正向文本提示,不能超过2500个字符 |
| negative_prompt | string | 否 | 负向文本提示,不能超过2500个字符 |
| aspect_ratio | string | 否 | 画面比例,枚举:16:9、9:16、1:1 |
| callback_url | string | 否 | 结果回调地址 |
| cfg_scale | number | 否 | 创意想象力,取值范围 [0,1] |
| mode | string | 否 | 视频模式,枚举:std(标准)、pro(高质,价格3.5倍) |
| camera_control | object | 否 | 运镜控制,下设type/config |
| duration | string | 否 | 视频时长(秒),枚举:5、10 |
| model_name | string | 否 | 模型版本,枚举:kling-v1、kling-v1-5、kling-v1-6、kling-v2-master、kling-v2-1-master、kling-v2-5-turbo |
示例请求
curl 示例
bash
curl -X POST "https://api.gpt.ge/kling/v1/videos/text2video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxx" \
-d '{
"model_name": "kling-v1-6",
"prompt": "20岁的女生,瓜子脸,五官精致,鹅蛋脸,黑色长发,皮肤白暂,氛围光线,穿着一袭白色短裙,坐在街道旁边的长椅上,面带微笑,甩着头发",
"mode": "std",
"aspect_ratio": "1:1",
"duration": "5"
}'JavaScript (fetch) 示例
javascript
fetch('https://api.gpt.ge/kling/v1/videos/text2video', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer sk-xxxx'
},
body: JSON.stringify({
model_name: 'kling-v1-6',
prompt: '20岁的女生,瓜子脸,五官精致,鹅蛋脸,黑色长发,皮肤白暂,氛围光线,穿着一袭白色短裙,坐在街道旁边的长椅上,面带微笑,甩着头发',
mode: 'std',
aspect_ratio: '1:1',
duration: '5'
})
}).then(r => r.json()).then(console.log)Python 示例(requests)
python
import requests
resp = requests.post(
'https://api.gpt.ge/kling/v1/videos/text2video',
headers={
'Content-Type': 'application/json',
'Authorization': 'Bearer sk-xxxx'
},
json={
'model_name': 'kling-v1-6',
'prompt': '20岁的女生,瓜子脸,五官精致,鹅蛋脸,黑色长发,皮肤白暂,氛围光线,穿着一袭白色短裙,坐在街道旁边的长椅上,面带微笑,甩着头发',
'mode': 'std',
'aspect_ratio': '1:1',
'duration': '5'
}
)
print(resp.json())返回字段
200 成功
| 字段 | 类型 | 描述 |
|---|---|---|
| code | integer | 返回码,0 表示成功 |
| message | string | 返回信息 |
| request_id | string | 请求唯一ID |
| data.task_id | string | 任务ID |
| data.task_status | string | 任务状态,如 submitted |
| data.created_at | integer | 创建时间戳 |
| data.updated_at | integer | 更新时间戳 |
| data.task_result.images | array | 结果图片列表 |
| data.task_result.videos | null | 视频结果(空) |
返回示例
json
{
"code": 0,
"message": "SUCCEED",
"request_id": "CmYgjmbyMToAAAAAAF6svw",
"data": {
"task_id": "CmYgjmbyMToAAAAAAF6svw",
"task_status": "submitted",
"created_at": 1727338013674,
"updated_at": 1727338013674
}
}