Skip to main content
POST
/
v1
/
images
/
generations
curl -X POST https://gogogotoken.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist logo of a giraffe, flat vector style, yellow and brown",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1730000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}
使用 OpenAI Images API 兼容格式生成图片，支持 gpt-image 系列及 DALL-E 等图像模型。 
curl -X POST https://gogogotoken.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist logo of a giraffe, flat vector style, yellow and brown",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1730000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

​
接口说明

该接口适合文生图场景。部分模型或渠道可能返回 b64_json 而非 url，前端需要根据响应字段做对应处理。
完整图像模型列表以 GET /v1/models 返回为准，可用范围取决于 API Key 分组权限。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。
​
Content-Type
string
required
固定为 application/json。

​
请求体

​
model
string
default:"gpt-image-1"
required
图像模型 ID，例如 gpt-image-1、dall-e-3。请以 GET /v1/models 返回结果为准。
​
prompt
string
required
图片描述。
​
n
integer
default:1
生成数量，默认 1。不同模型支持的最大数量可能不同。
​
size
string
default:"1024x1024"
图片尺寸，例如 1024x1024、1792x1024。可选值取决于模型。
​
quality
string
图片质量，例如 standard、hd。仅在模型支持时生效。
​
response_format
string
返回格式，例如 url 或 b64_json。部分模型可能由上游配置决定。

​
响应体

​
created
integer
响应创建时间戳。
​
data
object[]
图片结果数组。
​
url
string
可访问的图片 URL。
​
b64_json
string
base64 编码的图片内容。

​
图像编辑

如需图片编辑，请调用 POST /v1/images/edits。该接口支持 multipart/form-data 上传原图与蒙版，具体可用性取决于模型与渠道。

​
错误码

状态码含义处理建议
401API Key 无效或未传检查请求头与令牌状态
403无权限访问目标图像模型检查 API Key 分组权限
429触发限速降低请求频率或调整套餐
5xx上游或网关异常稍后重试，并查看控制台日志