SuperAPI AI 工具集

cloudrelay-imagegen

设计与创作

查看项目

更新于 10-15 20:13

技能介绍

用途:把 CloudRelay 作为位图生成的默认提供方,普通“生成图片/海报/logo/插画/变体”等请求会自动启用;仅当用户明确指定其他提供方或需要 CloudRelay 不具备的能力时才改用别的方案。未指定渠道时使用 GPT 与默认模型 gpt-image-2.5-flare,不因缺密钥、模型不可用或耗时而静默切换渠道。

主要能力:三个渠道共用同一网关协议——GET /v1/media/models、POST /v1/images/generations/async、GET /v1/images/tasks/{task_id},均用 Authorization: Bearer。GPT 用 CLOUDRELAY_GPT_IMAGE_API_KEY(生图专用组),Gemini 用 CLOUDRELAY_GEMINI_API_KEY(gemini 组),Grok 用 CLOUDRELAY_GROK_API_KEY(grok 组)。提交前先做模型发现,模型须存在、kind=image 且走统一 images 端点,async=false 的模型会被拒绝。Gemini 需用户先确认 gemini-3.1-flash-image-preview 或 gemini-3-pro-image-preview 之一。

使用方式:先检查所选渠道密钥,如 python "<skill-directory>/scripts/configure_api_key.py" --provider gpt --check;缺密钥时提示终端配置或经 stdin 传入,不要把 key 放进命令行参数。随后运行 scripts/generate_image.py,参数含 --provider、--prompt、--model、--size、--quality、--count、--output-dir、--poll-timeout。默认 size auto、quality auto、count 1。完成后须确认输出文件存在并检查图像,报告绝对路径与参数摘要,绝不输出密钥值。

限制:分辨率由 size 控制,2K/4K 尺寸表为来源约定而非保证;上游可能按像素预算缩减,需读取实际像素并单独报告。401/403 应提示密钥被拒且不换渠道;429 报告限额并停止,不自动重复付费生成;发现失败、模型不可用或 async=false 应在提交前停止。更新仅信任该仓库 GitHub Releases 资产并校验 SHA-256,更新后需重启宿主代理。脚本仅用 Python 标准库,凭据边界固定为 https://cloudrelay.cn。