API工厂文档
API 参考OpenAI Images

生成图像

在给定提示的情况下创建图像。GPT-Image-2 支持任意尺寸、质量控制、流式生成等功能。

注意事项

以下参数在当前实现中存在边界值修正或不生效的情况,如果使用到以下参数请注意。

边界值修正(不报错,自动修正):

参数规范范围无效输入实际行为
output_compression[0, 100]-1101 等越界值自动修正,不返回 400
size长边/短边 ≤ 3:13840x16(240:1 超出限制)自动修正为 1942×809(约 2.4:1),不返回 400

不生效的参数:

参数无效输入实际行为
n02411始终只返回 1 张图片(n 参数整体无效)
POST
/v1/images/generations

Authorization

BearerAuth
AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer xxxxxx

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api.3hei.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-2",    "prompt": "一本儿童绘本插画,画着兽医正用听诊器倾听一只小水獭的心跳。",    "size": "1024x1024",    "quality": "medium"  }'
{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "url": "string",
      "revised_prompt": "string"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    }
  }
}