Appearance
Kling AI · 概览
接口与可灵官网 API 兼容;字段说明以官网为准
核心说明
- 接口兼容性:API 2.0 使用
/kling/text-to-video/kling-3.0、/kling/image-to-video/kling-3.0与/kling/tasks;旧/kling/v1/**接口继续兼容。 - 字段与示例:详细字段、取值范围、约束条件以官方文档为准。
- 任务 ID 契约:创建响应中
task_id为上游原始任务 ID,platform_id为 Fhddos 平台统一追踪 ID(video_或image_)。查询接口同时接受上游task_id、平台platform_id和external_task_id。 - 主要能力:
- 文生视频(text2video)
- 图生视频(image2video)
- Omni 视频(omni-video)
- 动作控制(motion-control)
- 多图参考生视频(multi-image2video)
- 视频特效(video-effects)
- 视频延长(video-extend)
- 对口型(advanced-lip-sync)
- 图像生成(generations)
- Omni 图像(omni-image)
- 多图参考生图(multi-image2image)
- 多模态视频编辑(multi-elements)
计费说明
- 采用"终态实扣,失败不扣"的异步计费模式;
- 创建任务仅落库,不对用户/Token 实际扣费;
- 当任务进入终态(成功/失败)后,由后台轮询器一次性结算,仅成功任务会扣费;
- 当上游响应包含
final_unit_deduction时:- 视频按积分计费:1 积分 = 1 元
- 图像按积分计费:1 积分 = 0.025 元
- 若响应不含
final_unit_deduction,任务不计费并标记为结算失败。 - 仅保留两类积分 SKU:
kling-video-points(视频)与kling-image-points(图像)。 - API 2.0 的 Kling 3.0 视频成功后按
duration × 官方 Units/秒结算;billing[]仅作为上游消费证据。
官方链接
路由与认证
- 认证:
Authorization: Bearer - 路由:统一使用
/kling前缀
支持的模型
视频模型
| 模型名称 | 适用场景 |
|---|---|
kling-3.0 | API 2.0 路径版本,仅用于 /text-to-video/kling-3.0 与 /image-to-video/kling-3.0 |
kling-video-o1 | Omni 视频生成 |
kling-v1 | 文生/图生视频 |
kling-v1-5 | 文生/图生视频 |
kling-v1-6 | 文生/图生视频、多图参考生视频、多模态编辑 |
kling-v2-master | 高级视频生成 |
kling-v2-1 | 新一代视频生成 |
kling-v2-1-master | 专业级视频生成 |
kling-v2-5-turbo | 新一代视频生成(Turbo) |
kling-v2-6 | 新一代视频生成(支持声音/动作控制) |
kling-v3 | Kling 3.0 视频生成、动作控制 |
kling-v3-omni | Kling 3.0 Omni 视频生成,仅用于 /videos/omni-video |
图像模型
| 模型名称 | 适用场景 |
|---|---|
kling-image-o1 | Omni 图像生成 |
kling-v1 | 文生图/图生图 |
kling-v1-5 | 文生图/图生图(支持图片参考) |
kling-v2 | 文生图/多图参考生图 |
kling-v2-new | 风格转绘(图生图) |
kling-v2-1 | 文生图/多图参考生图 |
kling-v3 | Kling Image 3.0 文生图/图生图 |
kling-v3-omni | Kling Image 3.0 Omni,仅用于 /images/omni-image |
说明:
kling-v1/kling-v1-5/kling-v2-1/kling-v3可在视频与图像能力中复用,实际计费以任务类型为准。kling-v3-omni仅通过 Omni 视频/videos/omni-video与 Omni 图像/images/omni-image入口展示。历史输入kling-v2-5会归一为kling-v2-5-turbo,不作为对外 canonical 模型展示。
当前暂不开放
| 能力 | 当前状态 | 说明 |
|---|---|---|
| 旧接口的 Kling 3.0 Turbo 别名 | blocked_pending_probe | API 2.0 已使用独立的 kling-3.0 路径版本,不推断旧 model_name 别名 |
| 数字人、TTS、文生音效、视频生音效、音色定制 | blocked_pending_probe | 本期不开放音频/数字人任务,未绑定计费 SKU |
人脸识别、identify-face | blocked_pending_probe | 涉及敏感能力;对口型前置识别流程本期不开放 |
| 主体智能补全图、扩图、虚拟试穿、图像识别 | blocked_pending_probe | 未完成官方 schema、结果 contract 与真实扣费探针 |
| 账户资源包/余额查询 | blocked_pending_probe | 不作为普通用户任务接口开放 |
快速上手
bash
# 文生视频(详细参数见官网)
curl -X POST "https://aiapi.fhddos.com/kling/v1/videos/text2video" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model_name": "kling-v1",
"prompt": "夕阳下的海滩,海浪轻轻拍打沙滩",
"mode": "std",
"duration": "5",
"aspect_ratio": "16:9"
}'
# 查询任务
curl "https://aiapi.fhddos.com/kling/v1/videos/text2video/$TASK_ID" \
-H "Authorization: Bearer $TOKEN"页面导航