图片生成

POST/v1/images/generations

通过统一的 OpenAI Images 兼容入口生成或编辑图片。

model 和 prompt 是网关固定要求。其余参数是否可用、可选值以及返回图片形式由所选模型和 Provider 路由决定。

核心请求字段

字段	类型	必填	说明
`model`	string	是	从 /v1/models 获取的图片模型 ID。
`prompt`	string	是	图片生成或编辑提示词。
`image_url`	string	否	单张参考图片 URL，仅在模型支持时使用。
`image_urls`	string[]	否	多张参考图片 URL，仅在模型支持时使用。
`bbox_list`	integer[][][]	否	参考图区域坐标，仅在模型支持时使用。
`enable_sequential`	boolean	否	启用顺序生成，仅在模型支持时使用。
`thinking_mode`	boolean	否	启用模型思考模式，仅在模型支持时使用。
`n`	integer	否	请求生成的图片数量，必须大于 0。
`size`	string	否	期望图片尺寸；可选值取决于模型。
`resolution`	string	否	期望分辨率；可选值取决于模型。
`quality`	string	否	期望质量档位；可选值取决于模型。
`background`	string	否	背景模式；仅在模型支持时生效。
`mask_url`	string	否	局部编辑遮罩 URL；仅在模型支持时生效。
`style`	string	否	风格提示；仅在模型支持时生效。
`watermark`	boolean	否	是否包含水印；仅在 Provider 支持时生效。
`response_format`	string	否	请求 URL 或 Base64 等返回形式；由路由支持情况决定。
`seed`	integer	否	随机种子；仅在 Provider 支持时使用。
`guidance_scale`	number	否	提示词引导强度；范围由模型决定。
`stream`	boolean	否	流式能力依模型路由而定，部分路由不支持。
`output_format`	string	否	输出文件格式；仅在模型支持时生效。
`sequential_image_generation`	string	否	顺序图片生成模式；仅在模型支持时使用。
`sequential_image_generation_options`	object	否	顺序生成选项；结构由模型决定。
`tools`	object[]	否	模型工具定义；仅在路由支持时转发。
`optimize_prompt_options`	object	否	提示词优化选项；结构由模型决定。
`user`	string	否	调用方自定义用户标识。
`metadata`	object	否	调用方自定义元数据。

请求示例

curl https://api.noxgate.net/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","prompt":"A quiet library at sunrise","n":1,"size":"1024x1024"}'

import requests

response = requests.post(
    "https://api.noxgate.net/v1/images/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={"model": "YOUR_MODEL_ID", "prompt": "A quiet library at sunrise", "n": 1},
)
print(response.json())

const response = await fetch("https://api.noxgate.net/v1/images/generations", {
  method: "POST",
  headers: { Authorization: "Bearer sk-your-api-key", "Content-Type": "application/json" },
  body: JSON.stringify({ model: "YOUR_MODEL_ID", prompt: "A quiet library at sunrise", n: 1 }),
});
console.log(await response.json());

成功响应

{
  "created": 1750000000,
  "data": [{ "url": "https://provider.example/generated-image.png", "size": "1024x1024" }],
  "usage": { "generated_images": 1 }
}

查询异步任务

GET/v1/images/generations/:task_id

创建响应含 status 和 id、但没有可用 data 时，使用任务 ID 轮询本端点。以 succeeded、failed 或 canceled 为终态，并为轮询设置最大等待时间。

curl "https://api.noxgate.net/v1/images/generations/image_task_example" \
  -H "Authorization: Bearer sk-your-api-key"

使用提示

不要假设所有图片模型都支持参考图、相同尺寸或相同可选参数。
响应 data 项可能包含 url 或 b64_json；客户端应按实际返回字段处理。
计费以所选模型配置和实际用量为准，文档不固定图片价格。