KIE.AI New API 插件

本插件是 New API 的第三方任务插件（task plugin），用于将 KIE 统一的异步任务 API 桥接到 New API 网关，让用户可以在 New API 中直接调用 KIE 的图像、视频和音频生成能力。

核心功能

• 74 款生成产品：覆盖图像 28 款、视频 40 款、音频 6 款（另有 2 款 Coming Soon 未开放），每个产品组映射到默认的 KIE createTask ID。
• 多种调用协议：
  • 原生 KIE 兼容端点：POST /kie/api/v1/jobs/createTask、GET /kie/api/v1/jobs/recordInfo/:taskId，请求体与 KIE 官方一致。
  • OpenAI Responses 协议：支持 POST /v1/responses，支持文本/图片多模态输入、metadata.input 传递模型专属参数，产物以 <img> / <video> / <audio> 标签返回。
  • OpenAI Video 协议：支持 POST /v1/videos，可传入参考图片 URL 和额外参数。
• 参考媒体处理：仅支持 URL 参考，建议先通过 KIE 文件上传 API 获取临时链接（免费，24 小时有效），再传入模型要求的字段（如 image_urls）。
• 精准计费：
  • 图像/工具类按实际交付文件数计费，提交时按 max_images / n / batch_size 预占。
  • 视频类按组合用量（seconds、resolution、tier 等）预占，完成时保留预占用量。
  • 音频类按文件数预占，文本转语音模型额外上报字符数。
• 错误处理：完整映射 KIE 错误码，区分不可恢复错误（直接任务失败）和临时错误（继续轮询）。

适合谁

• 已经部署 New API，并希望接入 KIE 生成能力的开发者或服务商。
• 需要统一管理多种生成模型（图像、视频、音频）并对外提供 API 服务的团队。
• 现有 KIE 集成用户，可无缝切换域名到 New API 网关。

安装与使用

支持第三方插件源安装（推荐）或手动上传 plugin.js。绑定 Task Plugin（type 61）渠道，填入 KIE API Key 即可。注意：渠道「测试」按钮固定返回不支持提示，属于 New API 核心设计，不影响正常任务提交。

注意事项

• 本插件为薄桥接层，产品专属参数原样透传，请参考 KIE 文档 使用。
• 产物链接约 24 小时过期，请及时转存。
• 同步对话模型（Claude/GPT/Gemini 等）不在本插件内，请使用原生通道接入。