---
title: "Seedream 4.5 - Edit image"
method: POST
path: "/v1/ai/text-to-image/seedream-v4-5-edit"
tags: ["text-to-image"]
---

# Seedream 4.5 - Edit image

`POST /v1/ai/text-to-image/seedream-v4-5-edit`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-image/seedream-v4-5-edit`
- Auth: API key in header `x-magnific-api-key`

Edit images using ByteDance's Seedream 4.5 model with text guidance.

**Key Features:**
- Preserves subject details, lighting, and color tone
- Supports up to 5 reference images
- Enhanced editing consistency
- Up to 4MP output resolution

**Best for:**
- Image-to-image editing
- Style transfer with consistency
- Multi-image reference editing

## Request body

- Ttisdv45EditRequestContent
  - `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"
  - `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.
  - `aspect_ratio` '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': 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
  - `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.
  - `enable_safety_checker` boolean: Whether to enable the content safety checker. When enabled, the model filters potentially unsafe content.
  - `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

## Response `200`

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

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)