跳转到内容
HiAPI Docs
HiAPI
中文
English 中文

Kling 3.0

概览

Section titled “概览”
提供商快手
模型名称kling-v3
主要端点/v1/videos
返回形式先返回 id，随后通过轮询获取结果
典型能力电影级画面、物理模拟、强动作表现、镜头运动

Kling 3.0 更适合需要明显镜头调度和强运动表达的短视频任务，比如飞行镜头、追逐镜头和高张力宣传片段。

适用场景

Section titled “适用场景”
  • 电影感短片、预告片、氛围宣传视频
  • 高动作密度场景，如奔跑、飞行、追逐
  • 需要镜头语言和空间运动的创意视频
  • 社交媒体开场视频和转场素材

端点

Section titled “端点”
  • POST /v1/videos
  • GET /v1/videos/{id}

关键参数

Section titled “关键参数”
参数类型说明
modelstring固定为 kling-v3
promptstring描述镜头、主体动作、环境和光线
secondsstring可选 "3"、"5"、"8"、"10"、"15"
sizestring例如 1920*1080（横版）、1080*1920（竖版）、1280*720

请求示例

Section titled “请求示例”
Terminal window
curl -X POST https://api.hiapi.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "A drone flyover of a misty mountain valley at sunrise, cinematic, smooth camera movement",
    "seconds": "5",
    "size": "1280*720"
  }'

响应示例

Section titled “响应示例”
{
  "id": "video_task_001",
  "object": "video",
  "status": "processing"
}

异步与轮询

Section titled “异步与轮询”

视频生成是异步任务。提交后轮询 GET /v1/videos/{id}，直到顶层 status 变为 completed，再读取返回的视频 URL。

Terminal window
curl -X GET https://api.hiapi.ai/v1/videos/video_task_001 \
  -H "Authorization: Bearer YOUR_API_KEY"

常见错误

Section titled “常见错误”
  • 400 Bad Request：seconds 或 size 不合法。
  • 401 Unauthorized：API Key 无效。
  • 429 Too Many Requests：并发过高，需要退避重试。
  • 500 或上游失败：复杂长镜头任务可能偶发失败，建议重试并简化提示词。

定价说明

Section titled “定价说明”

Kling 3.0 的实时价格请查看实时定价页。

下一步

Section titled “下一步”