Skip to main content
POST
/
v1
/
ai
/
text-to-image
/
seedream-v4-5-edit
Edit image - Seedream 4.5
curl --request POST \
  --url https://api.freepik.com/v1/ai/text-to-image/seedream-v4-5-edit \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "prompt": "A professional marketing poster with elegant typography",
  "reference_images": [
    "https://example.com/reference-image-1.jpg",
    "https://example.com/reference-image-2.jpg"
  ],
  "webhook_url": "https://www.example.com/webhook",
  "aspect_ratio": "square_1_1",
  "seed": 12345,
  "enable_safety_checker": true
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
prompt
string
required

Text description of the image you want to generate.

Tips:

  • Be specific about visual details, composition, and style
  • Seedream 4.5 excels at rendering text and typography
  • Describe lighting, atmosphere, and camera angles for best results

Examples:

  • Simple: "A modern logo design with clean typography"
  • Detailed: "Professional marketing poster for a tech startup, minimalist design, bold sans-serif typography, gradient blue background, high contrast"
Maximum string length: 4096
Example:

"A professional marketing poster with elegant typography"

​
reference_images
string[]
required

Array of reference images for image editing. Seedream 4.5 preserves subject details, lighting, and color tone when editing.

Supported formats:

  • Base64-encoded image strings
  • Publicly accessible image URLs

Image requirements:

  • Minimum resolution: 256x256 pixels
  • Maximum file size: 10MB per image
  • Supported formats: JPG, JPEG, PNG
Required array length: 1 - 14 elements

Image as Base64 encoded string or publicly accessible URL

Example:
[
  "https://example.com/reference-image-1.jpg",
  "https://example.com/reference-image-2.jpg"
]
​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

​
aspect_ratio
enum<string>
default:square_1_1

The aspect ratio of the generated image. Seedream 4.5 supports up to 4MP resolution.

Available options:

  • square_1_1: Square format (2048x2048) - Instagram feed, profile pictures
  • widescreen_16_9: Landscape (2730x1536) - YouTube thumbnails, presentations
  • social_story_9_16: Portrait (1536x2730) - TikTok, Instagram Stories
  • portrait_2_3: Tall portrait (1672x2508) - Pinterest pins
  • traditional_3_4: Classic photo (1774x2364) - Traditional photography
  • standard_3_2: Photo print (2508x1672) - Standard prints
  • classic_4_3: Monitor ratio (2364x1774) - Classic displays
  • cinematic_21_9: Ultra-wide (3062x1312) - Cinematic banners
Available options:
square_1_1,
widescreen_16_9,
social_story_9_16,
portrait_2_3,
traditional_3_4,
standard_3_2,
classic_4_3,
cinematic_21_9
Example:

"square_1_1"

​
seed
integer

Random seed for reproducibility. Using the same seed with identical parameters produces similar results. Useful for iterating on a design or creating variations.

Required range: 0 <= x <= 4294967295
Example:

12345

​
enable_safety_checker
boolean
default:true

Whether to enable the content safety checker. When enabled, the model filters potentially unsafe content.

Response

OK - The request has succeeded and the Seedream 4.5 edit process has started.

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}