Skip to main content

接口说明

端点: POST https://geekapis.com/v1/images/generations 调用此接口,通过 GPT-Image-2 模型根据文字描述(及可选参考图)生成图像。接口采用同步任务模式——请求成功后立即返回一个结果。 支持三种使用模式:
  • 文生图:仅提供 prompt,由模型创作图像
  • 单图参考:提供 1 张参考图 + prompt,在参考图风格基础上生成
  • 多图参考:提供多张参考图(最多 4 张)+ prompt,融合多图生成

请求参数

认证

所有请求须在 Header 中携带 Bearer Token:
前往 API Key 管理页面 获取您的密钥。

Body 参数

string
required
图像生成模型名称。固定填写 gpt-image-2示例:"gpt-image-2"
string
required
图像生成的文字描述。支持中英文,建议详细描述场景、风格、构图和光线。最长 32,000 个字符(OpenAI GPT Image 模型官方上限)。
string
输出图像的宽高比必须为具体清晰度,默认值:"1024x1024"可用值取决于所选 resolution
  • 1K :1:1=1024x1024, 9:16=720x1280, 16:9=1280x720, 3:2=1248x832,
  • 2K:1:1=2048x2048, 9:16=1440x2560, 16:9=2560x1440, 3:2=2496x1664, 4:3=2304x1728, 3:4=1728x2304, 2:3=1664x2496,
  • 4K:9:16=2160x3840, 16:9=3840x2160,
  • 1K :1:1=1024x1024, 9:16=720x1280, 16:9=1280x720, 3:2=1248x832,
  • 2K:1:1=2048x2048, 9:16=1440x2560, 16:9=2560x1440, 3:2=2496x1664, 4:3=2304x1728, 3:4=1728x2304, 2:3=1664x2496,
  • 4K:9:16=2160x3840, 16:9=3840x2160,
也可传入 "auto",由服务端根据 prompt 内容自动选择最合适的比例。
string[]
参考图 URL 数组,用于图生图(推荐字段)。
  • 支持 PNG / JPG 格式,单张 ≤ 2MB
  • 最多 4 张

代码示例


响应示例

200 OK