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

# Image to Image

> Seedream Image-to-Image — Generate new images based on reference images

Uses the same models as Text to Image. When the `input` contains an `imageUrls` field, it automatically switches to image-to-image mode.

<ParamField body="model" type="string" required>
  Model name, e.g. `seedream-4.5`. Uses the same models as Text to Image.
</ParamField>

<ParamField body="callBackUrl" type="string">
  Webhook callback URL.
</ParamField>

<ParamField body="input" type="object" required>
  <Expandable title="properties" defaultOpen>
    <ParamField body="prompt" type="string" required>
      Prompt describing the transformation you want to apply.
    </ParamField>

    <ParamField body="imageUrls" type="array" required>
      List of reference image URLs, 1 to 10.
    </ParamField>

    <ParamField body="ratio" type="string">
      Image aspect ratio. Options: `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`.
    </ParamField>

    <ParamField body="resolution" type="string">
      Resolution. Options: `1k`, `2k`, `4k`.
    </ParamField>

    <ParamField body="n" type="integer">
      Number of images to generate. Default `1`. Billing scales linearly with `n`.

      * `seedream-5-lite`: 1–4
      * `seedream-4` / `seedream-4.5`: 1–15
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.maxapi.io/api/v1/task/submit \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
    "model": "seedream-4.5",
    "callBackUrl": "https://example.com/webhook",
    "input": {
      "prompt": "Transform to watercolor style",
      "imageUrls": ["https://example.com/photo.jpg"],
      "ratio": "16:9",
      "resolution": "2k"
    }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Submitted successfully theme={null}
  {
    "code": 0,
    "msg": "ok",
    "data": {
      "taskId": "c3d4e5f6-a7b8-9012-cdef-234567890abc"
    }
  }
  ```
</ResponseExample>

***

## Query Result

Retrieve the generation result via the [Query Task](/api-reference/query-task) endpoint or Webhook:

```json theme={null}
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "c3d4e5f6-a7b8-9012-cdef-234567890abc",
    "status": "SUCCESS",
    "input": {
      "model": "seedream-4.5",
      "prompt": "Transform to watercolor style",
      "imageUrls": ["https://example.com/photo.jpg"],
      "ratio": "16:9",
      "resolution": "2k"
    },
    "result": {
      "type": "image",
      "urls": [
        "https://example.com/output/result1.png",
        "https://example.com/output/result2.png"
      ]
    },
    "created_at": "2026-02-10T22:00:00.000000Z",
    "updated_at": "2026-02-10T22:00:15.000000Z"
  }
}
```