Skip to content

任务:文生视频

概览

  • 请求方法:POST
  • 路径:/kling/v1/videos/text2video
  • 内容类型:application/json

认证方式

  • HTTP Bearer:Authorization: Bearer <token>

请求参数

Body 参数(JSON)

参数类型必填描述
promptstring正向文本提示,不能超过2500个字符
negative_promptstring负向文本提示,不能超过2500个字符
aspect_ratiostring画面比例,枚举:16:9、9:16、1:1
callback_urlstring结果回调地址
cfg_scalenumber创意想象力,取值范围 [0,1]
modestring视频模式,枚举:std(标准)、pro(高质,价格3.5倍)
camera_controlobject运镜控制,下设type/config
durationstring视频时长(秒),枚举:5、10
model_namestring模型版本,枚举: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 成功

字段类型描述
codeinteger返回码,0 表示成功
messagestring返回信息
request_idstring请求唯一ID
data.task_idstring任务ID
data.task_statusstring任务状态,如 submitted
data.created_atinteger创建时间戳
data.updated_atinteger更新时间戳
data.task_result.imagesarray结果图片列表
data.task_result.videosnull视频结果(空)

返回示例

json
{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "CmYgjmbyMToAAAAAAF6svw",
  "data": {
    "task_id": "CmYgjmbyMToAAAAAAF6svw",
    "task_status": "submitted",
    "created_at": 1727338013674,
    "updated_at": 1727338013674
  }
}