bytedance/seedream/5.0/lite/edit
Seedream 5.0 Lite — Fast Text-to-Image API The lightweight version of Seedream 5.0, delivering high-quality, low-latency AI image generation from text prompts. Ideal for real-time creative tools, e-commerce visuals, and...
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runbytedance/seedream/5.0/lite/editInput Schema
4 parameters · 2 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
images | string[] | Required | The URLs of the images to use for image-to-image generation or image editing. |
prompt | string | Required | The text prompt to generate an image from. · Min length: 3 · Max length: 50000 · Default: "Generate 3 images of a girl and a cow plushie happily riding a roller coaster in an amusement park, depicting morning, noon, and night." |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16 21:916:93:24:31:13:42:39:16 |
output_format | string | Optional | The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bytedance/seedream/5.0/lite/edit",
"images": [
"https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/77024d8e03f24862b066bfc385301120~tplv-goo7wpa0wc-image.image",
"https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2cbc5cf5a68d44899fc52f177fb9cf51~tplv-goo7wpa0wc-image.image"
],
"prompt": "Generate 3 images of a girl and a cow plushie happily riding a roller coaster in an amusement park, depicting morning, noon, and night.",
"output_format": "png"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Seedream v5.0 Lite Editing
Seedream v5.0 Lite Editing brings the Seedream 5.0 image workflow to faster everyday creation and editing. It is intended for prompt-led visual production where clear composition, usable text, and dependable instruction following matter, without requiring the heavier Pro route for every iteration.
The Lite route is well suited to concept exploration, campaign variants, social assets, and practical image revisions. It starts from supplied images and applies a written change while preserving the parts of the composition that should remain stable.
Highlights
- Fast creative iteration. Supports rapid exploration of visual directions before a team commits to final production.
- Instruction-led composition. Uses the prompt to coordinate subject, setting, style, layout, and requested textual elements.
- Practical design output. Targets clear, usable images for marketing, editorial, social, and concept-development workflows.
- Reference-preserving edits. Applies localized or broad changes while the supplied image continues to anchor identity and composition.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| Base generation | Per request | $0.035 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs revising an existing visual asset | The goal is a different media task or endpoint |
| The available inputs match the required local schema | Required source media or permissions are unavailable |
| The brief can specify subject, composition, style, and delivery | The result must be deterministic at pixel or sample level |
| The supported formats and controls match final placement | Delivery requires unsupported dimensions, codecs, or duration |
| An asynchronous generated result fits the workflow | A live, frame-synchronous, or real-time response is mandatory |
Prompt Guide
Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.
{
"prompt": "Generate 3 images of a girl and a cow plushie happily riding a roller coaster in an amusement park, depicting morning, noon, and night.",
"images": [
"https://example.com/reference.jpg"
],
"aspect_ratio": "21:9",
"output_format": "jpeg"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | bytedance/seedream/5.0/lite/edit |
| Input fields | images (array)<br>prompt (string)<br>aspect_ratio (string; 21:9, 16:9, 3:2, 4:3, 1:1, 3:4, 2:3, 9:16)<br>output_format (string; jpeg, png) |
| Required input | prompt, images |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
bytedance/seedance/2.0-officialbytedance/seedream/5.0/probytedance/seedance/2.5-official