text-to-image
ByteDance Seedream 4.5 Edit Sequential
Seedream 4.5 Edit Sequential performs multi-image editing while locking character and object identity across shots. It detects main subjects, preserves continuity, and applies controlled edits with up to 4K output. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
Use one of our client libraries to get started quickly.
ByteDance Seedream 4.5 Edit Sequential
Seedream 4.5 Edit Sequential performs multi-image editing while locking character and object identity across shots. It detects main subjects, preserves continuity, and applies controlled edits with up to 4K output. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
1. Calling the API
Submit a request
Send a POST request to start generation. The API returns immediately with a prediction ID for polling.
curl -X POST "https://api.vibedream.ai/api/v1/models/edit-sequential/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIBEDREAM_API_KEY" \
-d '{
"prompt": "A beautiful sunset over mountains with golden light",
"images": [
"https://example.com/image1.jpg"
],
"size": "4096x4096",
"max_images": 1,
"enable_base64_output": false,
"enable_sync_mode": false,
"Enable Safety Checker": false
}'2. Authentication
The API uses an API Key for authentication.
Get your API Key
Get your API key from vibedream.ai/models/api-keys.
Environment variable
export VIBEDREAM_API_KEY="your-api-key"
3. Queue & Results
Generation requests are queued and processed asynchronously. Poll the prediction endpoint until status is completed or failed.
Submit request
curl -X POST "https://api.vibedream.ai/api/v1/models/edit-sequential/generate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIBEDREAM_API_KEY" \
-d '{
"prompt": "A beautiful sunset over mountains with golden light",
"images": [
"https://example.com/image1.jpg"
],
"size": "4096x4096",
"max_images": 1,
"enable_base64_output": false,
"enable_sync_mode": false,
"Enable Safety Checker": false
}'Response
Returns immediately with a prediction ID. Use id to poll for results.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"statusUrl": "https://api.vibedream.ai/api/v1/predictions/550e8400-e29b-41d4-a716-446655440000",
"estimatedTime": "5-15s",
"costCents": 9,
"createdAt": "2025-01-15T12:00:00.000Z"
}Get the result
Polling
# Replace YOUR_PREDICTION_ID with the id from the submit response curl "https://api.vibedream.ai/api/v1/predictions/YOUR_PREDICTION_ID" \ -H "Authorization: Bearer $VIBEDREAM_API_KEY" # Poll every 1-2s until status is "completed" or "failed"
Completed response
outputs is string[] — an array of direct download URLs hosted on assets.vibedream.ai.
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "edit-sequential",
"modelName": "ByteDance Seedream 4.5 Edit Sequential",
"status": "completed",
"outputs": [
"https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.png"
],
"error": null,
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:30.000Z"
}Failed response
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "edit-sequential",
"modelName": "ByteDance Seedream 4.5 Edit Sequential",
"status": "failed",
"outputs": null,
"error": "Your request was flagged by content moderation. Please modify your prompt.",
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:05.000Z"
}| Field | Type | Description |
|---|---|---|
| id | string | Unique prediction ID (UUID). |
| modelId | string | ID of the model used for generation. |
| modelName | string | Human-readable model name. |
| status | string | Current status. One of: processing, completed, failed. |
| outputs | string[] | null | Array of output URLs. Each URL is a direct download link to the generated file on assets.vibedream.ai. null when still processing or failed. |
| error | string | null | Error message if the generation failed. null on success. |
| createdAt | string | ISO 8601 timestamp when the request was submitted. |
| completedAt | string | null | ISO 8601 timestamp when generation finished. null while processing. |
4. Schema
Input
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | -- | -- | The edit prompt describing the shared change you want across the whole set. |
| images | string | string[] | Yes | -- | -- | Upload source images to edit sequentially, containing the same main subject or product.Pass a single image URL (string) or multiple image URLs (string[]). Accepted formats: JPEG, PNG, GIF, WebP. |
| size | string | No | -- | 4096x4096, 2048x2048, 1024x1024 | Select the target resolution. Supports sizes up to 4096 × 4096 for maximum detail. |
| max_images | number | Yes | -- | 1 – 10 (step 1) | Specify how many edited outputs you want the model to generate from your input set. |
| enable_base64_output | boolean | No | -- | -- | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
| enable_sync_mode | boolean | No | -- | -- | If set to true, the function will wait for the result to be generated and uploaded before returning the response. |
| Enable Safety Checker | boolean | No | -- | -- | Enable safety precautions for the outputs. |
Example request
{
"prompt": "A beautiful sunset over mountains with golden light",
"images": [
"https://example.com/image1.jpg"
],
"size": "4096x4096",
"max_images": 1,
"enable_base64_output": false,
"enable_sync_mode": false,
"Enable Safety Checker": false
}Output
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"modelId": "edit-sequential",
"modelName": "ByteDance Seedream 4.5 Edit Sequential",
"status": "completed",
"outputs": [
"https://assets.vibedream.ai/outputs/550e8400-e29b-41d4-a716-446655440000/1736942400000-0.png"
],
"error": null,
"createdAt": "2025-01-15T12:00:00.000Z",
"completedAt": "2025-01-15T12:00:30.000Z"
}