SuperAPI AI 工具集

grok-imagine-image

通用与其它

查看项目

更新于 10-16 09:19

技能介绍

用途 本技能用于生成图片:调用 grok-imagine-image 模型,通过兼容 Grok2API / OpenAI 风格的接口 POST /v1/images/generations 生成图片。当用户要求用 Grok Imagine / grok-imagine-image 生成图片时使用。

主要能力

  • 通过 /v1/images/generations 接口生成图片,不使用 /v1/chat/completions 调用 grok-imagine-image。
  • 自带脚本 scripts/generate.py,可传入提示词、输出目录、名称标签、数量、尺寸、模型、API 地址、API Key、超时等参数。
  • 支持 --json 输出机器可读 JSON,便于 Agent 解析;支持 --no-download 只打印 API URL 不下载文件;支持 --response-format url|b64_json 选择 OpenAI 风格字段(若网关支持)。
  • 生成结果可保存到本地,并回报本地保存路径和可访问的图片 URL;若下载成功,会把本地图片路径展示给用户。

默认配置

  • API 地址:http://43.163.230.83:8000/v1
  • 模型:grok-imagine-image
  • 尺寸:1024x1024
  • 超时:180 秒
  • API Key:写在 scripts/generate.py 中的占位符(DEFAULT_API_KEY) 可用环境变量或参数覆盖:GROK_IMAGINE_API_KEY / --api-key、GROK_IMAGINE_API_BASE / --api-base、GROK_IMAGINE_MODEL / --model。

使用方式 在任意工作区执行: python "$CODEX_HOME/skills/grok-imagine-image/scripts/generate.py" --prompt "a cozy reading nook with soft daylight" --output-dir ./outputs --name-tag reading-nook --json Windows 绝对路径示例: python "C:\Users\Administrator.codex\skills\grok-imagine-image\scripts\generate.py" --prompt "a simple red apple on a white background" --output-dir "./outputs" --json 脚本参数示例: python scripts/generate.py --prompt "..." --prompt-file ./prompt.txt --output-dir ./outputs --name-tag my-image --n 1 --size 1024x1024 --model grok-imagine-image --api-base http://43.163.230.83:8000/v1 --api-key g2a_xxx --timeout 180 --json 工作流程建议:确认用户需要生成图片;写清楚提示词(该接口通常英文 prompt 效果更稳);选择当前工作区下的输出目录(面向用户的图片优先放 outputs/);运行 scripts/generate.py;回报本地保存路径和可访问的图片 URL;若下载成功,把本地图片路径展示给用户。

密钥配置 首次正式使用前,请替换 scripts/generate.py 中的 DEFAULT_API_KEY = "g2a_REPLACE_ME",或设置环境变量: PowerShell 示例: $env:GROK_IMAGINE_API_KEY = "g2a_xxx" $env:GROK_IMAGINE_API_BASE = "http://43.163.230.83:8000/v1" 不要在用户可见回复中完整打印 API Key。

接口行为与限制

  • 只使用 /v1/images/generations,不要用 /v1/chat/completions 调 grok-imagine-image;若走 Chat Completions 失败,改回 images/generations。
  • 成功响应大致包含 created、data 数组,其中含 mime_type、revised_prompt、url 等字段。
  • 返回的媒体 URL 可能指向 127.0.0.1,脚本会在下载前改写为配置的公网主机地址。
  • 生图可能需要几十秒,超时时间请保持较高(默认 180 秒)。

失败处理

  • invalid_request / 缺少 model 或 prompt:检查请求体,确保 --prompt 非空。
  • 401/403:密钥缺失、仍是占位符,或未授权。
  • 超时:用相同 prompt 重试一次;生图本身可能较慢。
  • 生成成功但下载失败:回报改写后的公网 URL,并保留生成结果。

Agent 检查清单

  • 优先使用本技能自带脚本,不要手写临时 curl/Python。
  • 用户可见图片优先保存到工作区 outputs/。
  • 成功后简要汇报:使用的 prompt、本地路径、公网 URL。
  • 若用户提供了新的 base URL 或 key,优先用参数/环境变量传入,不要去改无关文件。