跳转到主要内容
POST
/
v1
/
images
/
generations
GPT-Image-2
curl --request POST \
  --url https://api.gravitex.ai/v1/images/generations \
  --header 'Authorization: <authorization>'

Documentation Index

Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt

Use this file to discover all available pages before exploring further.

简介

GPT-Image-2 支持文生图与图生图,统一使用 POST /v1/images/generations:不传 image 时为文生图;传入 image(URL 或 Base64)时自动进入图生图。响应固定为 Base64(b64_json),并返回 usage token 统计。 完整参数与多模型说明请参见 图片生成

认证

Authorization
string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

支持的模型

模型 ID说明
gpt-image-2OpenAI GPT-Image-2,支持 4K 与多尺寸

请求示例

curl -X POST "https://api.gravitex.ai/v1/images/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在星空下奔跑的白色猫咪,赛博朋克风格",
    "size": "1024x1536",
    "quality": "high",
    "n": 1
  }'

常用参数

  • model:固定为 gpt-image-2
  • prompt:图像描述或编辑指令
  • image:图生图参考图(URL 或 Base64,可字符串或数组)
  • size:如 1024x10241024x15361536x1024,或 4K 2880x2880 等(边长须为 16 的倍数)
  • qualitylowmediumhigh(默认 high
  • n:生成张数,1–10
响应 data[].b64_json 为 PNG Base64。multipart 上传与更多 edits 示例见 图像编辑;总览见 图片生成