> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modelhunter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Image to Image

> Edit and transform images using ByteDance Seedream models via Volcengine Ark. Supports reference-based generation with single or multiple input images.

## Body Parameters

<ParamField body="model" type="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
</ParamField>

<ParamField body="input" type="object" required>
  Input parameters for the generation.

  <Expandable title="properties">
    <ParamField body="prompt" type="string" required>
      Text description to guide the image editing or generation. Supports Chinese and English.

      **Recommended limits:** 300 Chinese characters or 600 English words.
    </ParamField>

    <ParamField body="image" type="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
    </ParamField>

    <ParamField body="images" type="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.
    </ParamField>

    <ParamField body="size" type="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]
    </ParamField>

    <ParamField body="width" type="number">
      Output width in pixels. Alternative to `size`. Must satisfy total pixel and aspect ratio constraints above. 128-aligned.
    </ParamField>

    <ParamField body="height" type="number">
      Output height in pixels. Use together with `width`. Must satisfy total pixel and aspect ratio constraints above. 128-aligned.
    </ParamField>

    <ParamField body="watermark" type="boolean" default={true}>
      Whether to add a watermark to the generated image.
    </ParamField>

    <ParamField body="optimize_prompt" type="string">
      Prompt optimization mode.

      * **Seedream 4.0/4.5**: Options: `standard`, `fast`
      * **Seedream 5.0**: Only supports `standard`
    </ParamField>

    <ParamField body="output_format" type="string">
      **Seedream 5.0 only.** Output image format. Options: `png`, `jpeg`.
    </ParamField>

    <ParamField body="web_search" type="boolean">
      **Seedream 5.0 only.** Enable real-time web search to enhance generation with up-to-date information.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="webhookUrl" type="string">
  URL to receive a webhook when the task completes.
</ParamField>

<ParamField body="metadata" type="object">
  Custom key-value metadata to attach to the task.
</ParamField>

<ResponseExample>
  ```json 202 theme={null}
  {
    "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
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "code": "VALIDATION_ERROR",
      "message": "Invalid request parameters"
    }
  }
  ```
</ResponseExample>