Images Generations
Images API 的 Generations operation。
Images API 的 Generations operation
Images API 的 Generations operation 使用 /v1/images/generations，按对应调用入口选择模型商品和上游，并按实际成功返回的图片数量结算。它不是 Chat Completions 或 Responses 的别名，也不是独立顶级协议。
路径
| 用途 | 方法与路径 |
|---|---|
| 图片生成 | POST /v1/images/generations |
请求示例
curl https://dingjiai.com/v1/images/generations \
-H "Authorization: Bearer YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Images Generations 可用的 public model id",
"prompt": "一只玻璃质感的蓝色机械鸟，白色背景",
"size": "1024x1024",
"n": 1
}'请求字段
Prop
Type
n 是平台层数量上限
n 只能是 1 到 4 的整数；传 n<1、n>4 或非整数会返回 invalid_image_count，且不会调用上游、不会扣费。其他图片参数例如缺少 prompt、尺寸不支持或模型不支持某个参数时，错误仍由上游返回。
模型选择
当前没有对外的 Images Generations 专用模型列表。接入时请使用控制台或管理员明确开放给 openai_images_generations 内部调用入口的 public model id。
模型商品按调用入口隔离
GET /v1/models 只返回 OpenAI Chat Completions 调用入口已发布的模型商品，不能证明 Images Generations operation 可用。图片模型必须在 openai_images_generations 内部调用入口下单独开放。
响应与计费
n=1 时网关返回单次上游响应，且最多交付 1 张图片。n=2..4 时，网关会发起多次上游单图请求，最多同时执行 2 个子请求，并把成功响应里的图片聚合到一个 OpenAI-compatible 响应中。每个子请求都占用真实上游并发槽；达到上游并发上限或总 fanout 超时后，未成功的子请求按部分失败处理。
成功结算时，顶级AI读取最终响应体 data 数组中实际返回的图片数量；每个带 url 或 b64_json 的条目计为 1 张图片。
Prop
Type
图片数量以响应为准
n 表示本次最多尝试生成的图片数量。成功几张就返回几张、扣几张；如果 0 张成功，整次请求失败且不写 usage log、不扣费。
最后更新于