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

# Seedream 4.0 · Image to image

> Multi-reference & multi-image generation.

[← Seedream](/api-documentation/ai-generation/models/seedream)

**Model name:** `bytedance/seedream/v4/edit`\
**Generation type:** `image_to_image`\
**Endpoint:** [`POST /api/asset_generator/`](/api-reference/ai-generation/post-ai-generation)

## Pricing

**0.5** credits per output.

Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

## Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.creatify.ai/api/asset_generator/ \
    --header 'Content-Type: application/json' \
    --header 'X-API-ID: your-api-id' \
    --header 'X-API-KEY: your-api-key' \
    --data '{
      "model_name": "bytedance/seedream/v4/edit",
      "input_params": {
        "prompt": "Place her in a bright café with soft morning light.",
        "image_urls": [
          "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
        ]
      }
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.creatify.ai/api/asset_generator/",
      headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
      json={
          "model_name": "bytedance/seedream/v4/edit",
          "input_params": {
              "prompt": "Place her in a bright café with soft morning light.",
              "image_urls": [
                  "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
              ]
          },
      },
  )
  print(response.json()["id"])
  ```
</CodeGroup>

## Input parameters

Send these fields in `input_params`.

<ParamField body="prompt" type="string" required>
  The text prompt describing how to edit the image. Max 5000 characters.

  Minimum characters: `1`.
  Maximum characters: `5000`.
</ParamField>

<ParamField body="seed" type="integer">
  Random seed for reproducibility. If None, a random seed is chosen.

  Minimum: `-1`.
  Maximum: `2147483647`.
</ParamField>

<ParamField body="image_urls" type="string[]">
  List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. If over 10 images are sent, only the last 10 will be used.

  Minimum items: `1`.
  Maximum items: `10`.
</ParamField>

<ParamField body="num_images" type="integer" default={1}>
  Number of images to generate. Values from 1 to 4.

  Minimum: `1`.
  Maximum: `6`.
</ParamField>

<ParamField body="aspect_ratio" type="string" default={"1:1"}>
  The size of the generated image. Width and height must be between 384 and 5000 pixels.

  Allowed values: `"1:1"`, `"4:3"`, `"16:9"`, `"3:4"`, `"9:16"`.
</ParamField>

<Accordion title="Complete JSON schema">
  ```json theme={null}
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "prompt"
    ],
    "properties": {
      "seed": {
        "type": "integer",
        "title": "Seed",
        "minimum": -1,
        "maximum": 2147483647,
        "description": "Random seed for reproducibility. If None, a random seed is chosen.",
        "x-advance-settings": true
      },
      "prompt": {
        "type": "string",
        "title": "Prompt",
        "maxLength": 5000,
        "minLength": 1,
        "description": "The text prompt describing how to edit the image. Max 5000 characters."
      },
      "image_urls": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "title": "Image URLs",
        "maxItems": 10,
        "minItems": 1,
        "description": "List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. If over 10 images are sent, only the last 10 will be used."
      },
      "num_images": {
        "type": "integer",
        "title": "Num Images",
        "default": 1,
        "maximum": 6,
        "minimum": 1,
        "examples": [
          1
        ],
        "x-ui-name": "output_nums",
        "description": "Number of images to generate. Values from 1 to 4."
      },
      "aspect_ratio": {
        "enum": [
          "1:1",
          "4:3",
          "16:9",
          "3:4",
          "9:16"
        ],
        "type": "string",
        "title": "Aspect Ratio",
        "default": "1:1",
        "x-ui-name": "aspect_ratio",
        "description": "The size of the generated image. Width and height must be between 384 and 5000 pixels."
      }
    }
  }
  ```
</Accordion>

## Response

The request returns the task with `status: "initializing"`. Poll [GET /api/asset\_generator/\{id}/](/api-reference/ai-generation/get-ai-generation-) until `status` is `done` or `failed`, or pass a `webhook_url` to be notified. A finished task lists its files in `assets` and the credits it charged in `credits_used`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.