Seedream5.5 - Image to Image

This reference documents the ModelFold gateway.

Endpoint

POST /images/generations

Full URL: https://modelfold.ai/v1/images/generations

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Input parameters for the generation task

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
model	string	Yes	The model name to use for generation. Required field. - Must be seedream/5-5-image-to-image for this endpoint Default："seedream/5-5-image-to-image"。 Allowed values：seedream/5-5-image-to-image。 Example：seedream/5-5-image-to-image。
prompt	string	Yes	Prompt required by the ModelFold gateway; at most 5000 characters. Required. Editing instruction, 5–5000 characters. minLength: 5. maxLength: 5000. Example：Keep the model's pose and the flowing shape of the liquid dress unchanged. Change the clothing material from silver metal to completely transparent clear water (or glass). Through the liquid water, the model's skin details are visible. Lighting changes from reflection to refraction.。
image_urls	array	Yes	Required. 1–10 publicly accessible reference image URLs. JPEG, PNG or WEBP, up to 10 MB each.
aspect_ratio	string	No	Aspect ratio of the output image. Default auto. Allowed values：1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 2:3 / 3:2 / 21:9 / auto。
size	string	No	Output size: 1K, 1.5K or 2K. Default 2K. If omitted, the gateway sends 2K.
output_format	string	No	Output image format. Defaults to png. Default："png"。 Allowed values：png / jpeg。 Example：png。
background	string	No	Background of the output image. Defaults to auto. - auto: decided by the model - transparent: transparent background - opaque: opaque background transparent is available only when output_format is png. Default："auto"。 Allowed values：auto / transparent / opaque。 Example：auto。
nsfw_checker	boolean	No	Defaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

Request Example

curl -X POST "https://modelfold.ai/v1/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream/5-5-image-to-image",
  "prompt": "Keep the model'\''s pose and the flowing shape of the liquid dress unchanged. Change the clothing material from silver metal to completely transparent clear water (or glass). Through the liquid water, the model'\''s skin details are visible. Lighting changes from reflection to refraction.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "aspect_ratio": "auto",
  "size": "1K",
  "output_format": "png",
  "background": "auto"
}'

{
  "model": "seedream/5-5-image-to-image",
  "prompt": "Keep the model's pose and the flowing shape of the liquid dress unchanged. Change the clothing material from silver metal to completely transparent clear water (or glass). Through the liquid water, the model's skin details are visible. Lighting changes from reflection to refraction.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "aspect_ratio": "auto",
  "size": "1K",
  "output_format": "png",
  "background": "auto"
}

Response

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