API 参考OpenAI Images
生成图像
在给定提示的情况下创建图像。GPT-Image-2 支持任意尺寸、质量控制、流式生成等功能。
注意事项
以下参数在当前实现中存在边界值修正或不生效的情况,如果使用到以下参数请注意。
边界值修正(不报错,自动修正):
| 参数 | 规范范围 | 无效输入 | 实际行为 |
|---|---|---|---|
output_compression | [0, 100] | -1、101 等越界值 | 自动修正,不返回 400 |
size | 长边/短边 ≤ 3:1 | 3840x16(240:1 超出限制) | 自动修正为 1942×809(约 2.4:1),不返回 400 |
不生效的参数:
| 参数 | 无效输入 | 实际行为 |
|---|---|---|
n | 0、2、4、11 | 始终只返回 1 张图片(n 参数整体无效) |
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
}
}
}