SuperAPI AI 工具集

ai-generation-client

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:该技能用于集成外部 AI 图像生成 API(如 Gemini、OpenAI 等),在调用不稳定或受限时提供更稳健的客户端封装。

主要能力:指数退避重试(延迟 1、2、4 秒);处理限流并遵循 Retry-After 响应头;检测内容策略违规(命中 safety、blocked、policy 等关键词时抛出内容策略错误且不重试);支持多轮对话上下文,便于以更低成本进行细化修改;支持传入输入图像与固定种子;返回图像数据、生成 ID、种子、推理耗时及可选的 thought signature。

使用方式:以 API Key 初始化 AIGenerationClient,构造 GenerationRequest(prompt、width、height,可选 model、seed、input_image、conversation_history),调用 generate 获取 GenerationResponse。多轮细化时把上一轮文本与图像数据放入 conversation_history。示例中默认模型为 gemini-2.0-flash-exp,基础地址为 generativelanguage.googleapis.com/v1beta,请求头使用 x-goog-api-key。

适用场景:需要为图像生成服务增加重试与限流保护的集成;需要检测并区分内容策略违规;需要多轮迭代优化同一张图。

限制与注意:内容策略错误不应重试,否则浪费配额;应设置合理超时(30–120 秒);需记录生成 ID 便于排查;忽略 Retry-After 可能导致被封禁。资料未提供具体收费、价格、平台支持范围与效果保证。