> ## 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 5.0 Pro · Image to image

> ByteDance's flagship image model specialized in character consistency, intent understanding, and professional typography with high-fidelity 2K output.

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

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

## Pricing

| Resolution | Credits |
| - | - |
| 1K | **1.5** |
| 2K | **2.0** |

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/v5/pro/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/v5/pro/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="image_urls" type="string[]" required>
  List of URLs of input images for editing. Up to 10 reference images. Per-image limits: aspect ratio (w/h) between 1/16 and 16; width and height > 14px; file size \<= 30MB; total pixels (w\*h) \<= 36,000,000.

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

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

  Minimum: `-1`.
  Maximum: `2147483647`.
</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="resolution" type="string" default={"2K"}>
  Image resolution

  Allowed values: `"1K"`, `"2K"`.
</ParamField>

<ParamField body="aspect_ratio" type="string" default={"1:1"}>
  The size of the generated image.

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

<ParamField body="output_format" type="string" default={"jpeg"}>
  output format of the image generate task

  Allowed values: `"jpeg"`, `"png"`.
</ParamField>

<Accordion title="Complete JSON schema">
  ```json theme={null}
  {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "prompt",
      "image_urls"
    ],
    "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,
        "max_file_size": 31457280,
        "max_pixels": 36000000,
        "min_aspect_ratio": 0.0625,
        "max_aspect_ratio": 16,
        "min_width": 15,
        "min_height": 15,
        "description": "List of URLs of input images for editing. Up to 10 reference images. Per-image limits: aspect ratio (w/h) between 1/16 and 16; width and height > 14px; file size <= 30MB; total pixels (w*h) <= 36,000,000."
      },
      "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."
      },
      "resolution": {
        "enum": [
          "1K",
          "2K"
        ],
        "type": "string",
        "title": "Resolution",
        "default": "2K",
        "description": "Image resolution",
        "x-advance-settings": true
      },
      "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."
      },
      "output_format": {
        "enum": [
          "jpeg",
          "png"
        ],
        "type": "string",
        "title": "Output Format",
        "default": "jpeg",
        "description": "output format of the image generate task",
        "x-advance-settings": true
      }
    }
  }
  ```
</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.