Kling Official 是 OpenMontage 生态中的提供方技能，专门用于通过 Kling 官方直连 API 调用相关工具，与 fal.ai 的 Kling 网关相互独立。
用途
该技能适用于 OpenMontage 中 provider="kling_official" 的工具调用，包括视频生成、图像生成、TTS、数字人与对口型等能力。它明确要求不得在 Kling 官方路径与 fal.ai 路径之间静默切换；若所选提供方不可用，应暴露阻塞并询问后再替代。
主要能力
- 视频：kling_official_video 对应官方视频端点，支持 classic、turbo、omni 三种 api_family；operation 使用 text_to_video、image_to_video、reference_to_video 等 OpenMontage 语义。
- 图像：kling_official_image 使用 api_family="generation" 或 "omni"，分别对应 /v1/images/generations 与 /v1/images/omni-image。
- 语音：kling_tts 使用官方音频 TTS 端点，参数包含 text、voice_id、voice_language（目前 zh 或 en）、voice_speed。
- 数字人：kling_avatar 使用 /v1/videos/avatar/image2video，接受头像 URL 或本地路径转 raw base64、audio_id 或 sound_file、可选 prompt 与 mode。
- 对口型：kling_lip_sync 分两步，先 POST /v1/videos/identify-face 获取 face_data[]，再 POST /v1/videos/advanced-lip-sync 提交 session_id 与 face_choose[]。
使用方式
认证使用 KLING_API_KEY，可选 KLING_API_BASE_URL 覆盖默认地址 https://api-singapore.klingai.com，请求头为 Authorization: Bearer <KLING_API_KEY>，请求体为 JSON。任务协议分为经典与 Turbo：经典创建返回 data.task_id，状态为 submitted、processing、succeed、failed，结果在 data.task_result.videos[]、images[]、audios[]；Turbo 创建返回 data.id，轮询 GET /tasks?task_ids=<id>，状态为 submitted、processing、succeeded、failed，结果在 data[0].outputs[]。解析器必须分开，不得模糊猜测。回调可传入 callback_url，但轮询仍是默认执行模式；经典与 Omni 在顶层传 callback_url，Turbo 在 options.callback_url 传。
适用场景
适用于需要在 OpenMontage 管线中显式选择 Kling 官方视频、图像、语音、数字人或对口型能力，并希望遵循官方任务协议、错误码与费用治理规范的场景。Video Omni 与 Image Omni 通过 api_family="omni" 在现有提供方工具内使用，不创建选择器级别的 Omni 操作。
限制
官方 Kling 为付费远程 API，提供方工具须返回非零保守估算并在成功付费结果中包含 cost_usd；高成本 Omni 输入需提高或标记估算。音频特效与视频特效虽为官方端点，但未注册为默认 OpenMontage 工具，不得从提供方实现中添加 sound_effects 或 video_effects 能力，也不得让视频特效进入普通 video_generation 选择器路径。本地视频路径不得静默上传至 fal.ai 或其他提供方，需提供可访问 URL。认证失败 1000-1004、余额或资源包耗尽 1101/1102、权限 1103、参数错误 1200/1201、安全策略 1301 不应重试；1302、1303、5000、5001、5002 可有限重试。Elements 为内部辅助，不创建或删除元素；Account Usage 仅用于诊断，不得在每次生成前调用。