GPT Image1.5 图生图

接口

POST /images/generations

完整 URL: https://modelfold.ai/v1/images/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

生成任务的输入参数

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于生成的模型名称。必填字段。 - 此端点必须使用 gpt-image/1.5-image-to-image 默认值："gpt-image/1.5-image-to-image"。 可选值：gpt-image/1.5-image-to-image。 示例：gpt-image/1.5-image-to-image。
input_urls	array<string>	是	上传图像文件作为 API 的输入（上传后的文件 URL，不是文件内容；接受类型：image/jpeg、image/png、image/webp；最大大小：10.0MB） maxItems: 16.
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。描述您想要生成的图像的文本提示 maxLength: 2000. 示例：Edit the image to dress the woman using the provided clothing images. Preserve her exact likeness, expression, hairstyle, and proportions. Replace only the clothing, fitting the garments naturally to her existing pose and body geometry with realistic fabric behavior. Match lighting, shadows, and color temperature to the original photo so the outfit integrates photorealistically, without looking pasted on.。
aspect_ratio	string	是	必填。图像的宽高比，决定其视觉形式。 可选值：1:1 / 2:3 / 3:2。 示例：3:2。
quality	string	是	必填。质量：medium=平衡，high=慢速/详细。 可选值：medium / high。 示例：medium。

请求示例

curl -X POST "https://modelfold.ai/v1/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image/1.5-image-to-image",
  "input_urls": [
    "https://example.com/reference.png"
  ],
  "prompt": "Edit the image to dress the woman using the provided clothing images. Preserve her exact likeness, expression, hairstyle, and proportions. Replace only the clothing, fitting the garments naturally to her existing pose and body geometry with realistic fabric behavior. Match lighting, shadows, and color temperature to the original photo so the outfit integrates photorealistically, without looking pasted on.",
  "aspect_ratio": "3:2",
  "quality": "medium"
}'

{
  "model": "gpt-image/1.5-image-to-image",
  "input_urls": [
    "https://example.com/reference.png"
  ],
  "prompt": "Edit the image to dress the woman using the provided clothing images. Preserve her exact likeness, expression, hairstyle, and proportions. Replace only the clothing, fitting the garments naturally to her existing pose and body geometry with realistic fabric behavior. Match lighting, shadows, and color temperature to the original photo so the outfit integrates photorealistically, without looking pasted on.",
  "aspect_ratio": "3:2",
  "quality": "medium"
}

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.png"
    }
  ],
  "usage": {}
}