Appearance
Kling API 2.0 · Kling 3.0
路径版本接口:文生视频、图生视频与统一任务查询
本页接口对齐 Kling 官方 API 2.0。调用 Fhddos 时仍使用 Fhddos Token;平台选中的 Kling 渠道则使用官网 API Key 调用新加坡上游。
路由
| 能力 | 方法与路径 |
|---|---|
| 文生视频 | POST /kling/text-to-video/kling-3.0 |
| 图生视频 | POST /kling/image-to-video/kling-3.0 |
| 按 ID 查询 | GET /kling/tasks?task_ids=... 或 external_task_ids=... |
| 游标查询 | POST /kling/tasks |
API 2.0 的版本写在 URL 中,不传旧接口的 model_name。旧 /kling/v1/** 路由和 kling-v3 模型名继续兼容,两套协议不会互相转换。
文生视频
bash
curl -X POST "https://aiapi.fhddos.com/kling/text-to-video/kling-3.0" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A train crossing a snowy valley at sunrise",
"settings": {
"resolution": "1080p",
"aspect_ratio": "16:9",
"duration": 5,
"audio": "off",
"multi_shot": true
},
"options": {
"external_task_id": "order-20260811-001",
"watermark_info": {"enabled": false}
}
}'图生视频
bash
curl -X POST "https://aiapi.fhddos.com/kling/image-to-video/kling-3.0" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"type": "prompt", "text": "The camera slowly pushes forward"},
{"type": "first_frame", "url": "https://example.com/frame.png"}
],
"settings": {"resolution": "720p", "duration": 5, "audio": "native"}
}'请求字段、枚举、输出和 billing[] 原样沿用官方 Kling 3.0 文生视频与图生视频契约。options.callback_url 会透传给 Kling,但仅允许公网 HTTPS 地址。
查询任务
bash
curl "https://aiapi.fhddos.com/kling/tasks?task_ids=$TASK_ID" \
-H "Authorization: Bearer $TOKEN"bash
curl -X POST "https://aiapi.fhddos.com/kling/tasks" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"limit":100,"filters":[{"key":"status","values":["succeeded"]}]}'查询只返回当前 Token 所属用户创建的 API 2.0 任务。按 ID 查询会从原任务的 Kling 渠道刷新官方结果;游标列表基于 Fhddos 已保存的任务快照,避免共享上游账号泄露其他租户任务。
计费
任务创建时不扣费;成功后按 duration × 官方 Units/秒 幂等结算到 kling-video-points,失败不扣费。
| 音频 | 720p | 1080p | 4K |
|---|---|---|---|
off | 0.6 Units/秒 | 0.8 Units/秒 | 3.0 Units/秒 |
native | 0.9 Units/秒 | 1.2 Units/秒 | 3.0 Units/秒 |
响应中的 billing[] 保留为 Kling 上游实际消费证据,不直接替代 Fhddos 客户价格。价格依据见官方视频价格。