Image to Image

curl --request POST \
  --url https://api.modelhunter.ai/api/v1/seedream/image-to-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>",
    "image": "<string>",
    "images": [
      "<string>"
    ],
    "size": "<string>",
    "width": 123,
    "height": 123,
    "watermark": true,
    "optimize_prompt": "<string>",
    "output_format": "<string>",
    "web_search": true
  },
  "webhookUrl": "<string>",
  "metadata": {}
}
'

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "type": "image-to-image",
    "provider": "seedream",
    "model": "seedream-4-5",
    "created_at": "2026-01-15T10:00:00Z",
    "estimated_seconds": 10
  }
}

POST

api

seedream

image-to-image

Image to Image

curl --request POST \
  --url https://api.modelhunter.ai/api/v1/seedream/image-to-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>",
    "image": "<string>",
    "images": [
      "<string>"
    ],
    "size": "<string>",
    "width": 123,
    "height": 123,
    "watermark": true,
    "optimize_prompt": "<string>",
    "output_format": "<string>",
    "web_search": true
  },
  "webhookUrl": "<string>",
  "metadata": {}
}
'

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "type": "image-to-image",
    "provider": "seedream",
    "model": "seedream-4-5",
    "created_at": "2026-01-15T10:00:00Z",
    "estimated_seconds": 10
  }
}

Body Parameters

model

string

required

Seedream model. Options:

seedream-5-0-lite — Latest, web search support, $0.04/image
seedream-4-5 — Flagship, multi-image reference input (up to 14), $0.04/image
seedream-4-0 — Multi-image reference input (up to 14), $0.03/image

input

object

required

Input parameters for the generation.

Show properties

prompt

string

required

Text description to guide the image editing or generation. Supports Chinese and English.Recommended limits: 300 Chinese characters or 600 English words.

image

string

required

Input image for editing or reference. Accepts a URL or base64-encoded data URI (data:image/png;base64,...).Image requirements:

Formats: jpeg, png (4.0/4.5 also support webp, bmp, tiff, gif)
Max size: 10 MB
Max dimensions: 6000x6000 pixels

images

string[]

Multiple reference images (up to 14). Each image as URL or base64. Supported on all models (5.0 Lite, 4.5, 4.0).Use this for multi-image reference generation where the model considers all provided images.

size

string

Output image size. Options: 1K, 2K, 4K, or WxH pixels (128-aligned). Default 2K.

4.0: Total pixels (w×h) in [921,600 ~ 16,777,216], aspect ratio [1:16 ~ 16:1]
4.5: Total pixels (w×h) in [3,686,400 ~ 16,777,216], aspect ratio [1:16 ~ 16:1]

width

number

Output width in pixels. Alternative to size. Must satisfy total pixel and aspect ratio constraints above. 128-aligned.

height

number

Output height in pixels. Use together with width. Must satisfy total pixel and aspect ratio constraints above. 128-aligned.

watermark

boolean

default:true

Whether to add a watermark to the generated image.

optimize_prompt

string

Prompt optimization mode.

Seedream 4.0/4.5: Options: standard, fast
Seedream 5.0: Only supports standard

output_format

string

Seedream 5.0 only. Output image format. Options: png, jpeg.

web_search

boolean

Seedream 5.0 only. Enable real-time web search to enhance generation with up-to-date information.

webhookUrl

string

URL to receive a webhook when the task completes.

metadata

object

Custom key-value metadata to attach to the task.

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "status": "pending",
    "type": "image-to-image",
    "provider": "seedream",
    "model": "seedream-4-5",
    "created_at": "2026-01-15T10:00:00Z",
    "estimated_seconds": 10
  }
}

Text to Image Text to Image

​Body Parameters

Body Parameters