Seedream 4.0 · Image to image

← Seedream Model name: bytedance/seedream/v4/edit
Generation type: image_to_image
Endpoint: POST /api/asset_generator/

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.

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"
      ]
    }
  }'

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"])

Input parameters

Send these fields in input_params.

string

required

The text prompt describing how to edit the image. Max 5000 characters.Minimum characters: 1. Maximum characters: 5000.

integer

Random seed for reproducibility. If None, a random seed is chosen.Minimum: -1. Maximum: 2147483647.

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.

integer

default:1

Number of images to generate. Values from 1 to 4.Minimum: 1. Maximum: 6.

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".

Complete JSON schema

{
  "$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."
    }
  }
}

Response

The request returns the task with status: "initializing". Poll GET /api/asset_generator/{id}/ 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.

Get Started

URL to Video

Aurora

Boreal

Stock AI Avatar

Custom Avatar

Custom Template

Asset Generator

Ad Clone

Text to Speech

IAB Images

HTML Interactive Ad

Link Parser

AI Ad Script

Stock AI Voice

Stock AI Music

Workspace

AI Shorts (Deprecated)

AI Editing (Deprecated)

Product Video (Deprecated)

Seedream 4.0 · Image to image

Pricing

Quick start

Input parameters

Response

​Pricing

​Quick start

​Input parameters

​Response

Pricing

Quick start

Input parameters

Response