用途:通过 Kie AI 的作业队列接口(/api/v1/jobs/createTask 与 /api/v1/jobs/recordInfo)提交并轮询图像、短视频生成任务,统一封装模型选择、参数差异、下载与失败恢复。
主要能力:默认图像模型为 gpt-image-2-text-to-image(GPT Image v2),支持 aspect_ratio 与 resolution 1K/2K/4K,返回 PNG;图生图/编辑用 gpt-image-2-image-to-image,通过 input_urls 传公开参考图。备用图像模型为 nano-banana-pro(1080p/2K)与 nano-banana-2(批量)。视频用 gemini-omni-video,支持 9:16、16:9、1:1,最长约 10 秒,可传 image_urls 参考图。资料明确不建议使用 Veo3。
使用方式:先设置 KIE_API_KEY(环境变量、macOS Keychain 或 ~/.config/kie/api_key),用 curl 提交任务取得 taskId,再轮询 recordInfo,成功后从 .data.resultJson 的 .resultUrls[0] 取结果 URL。下载时须加 -A 'Mozilla/5.0',否则 CDN 返回 403。
限制与失败处理:createTask 可能返回 HTTP 500,可重试最多 3 次;state 为 fail 时若为 PUBLIC_ERROR_UNSAFE_GENERATION 应改写提示词而非重试;视频请求 4/6 秒常返回 8/10 秒,需自行裁剪。安全过滤对候选人拒信措辞、竞品品牌文字、OAuth 弹窗、短于 3 秒唇动、可识别人物等敏感,且过滤具有间歇性。费用与积分按资料所列参考,失败不计费。具体价格、平台支持与更多细节以官方资料为准,暂未提供。