Skip to main content
POST
/
seedream-5.0-lite-edit
/
async
Seedream 5.0 Lite Edit
curl --request POST \
  --url https://api.modellix.ai/api/v1/bytedance/seedream-5.0-lite-edit/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "preserve composition, convert to watercolor style with rich texture and soft shadows",
  "image": [
    "https://example.com/input-1.jpg",
    "https://example.com/input-2.jpg"
  ]
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json
​
prompt
string
required

Image editing instruction, supports Chinese and English

Required string length: 1 - 600
Example:

"Convert this image to a watercolor painting style"

​
image
string[]
required

Input image array (1-14 images). Each image must be <= 10 MB. Supported formats: JPEG, PNG, WEBP, BMP, TIFF, GIF.

Required array length: 1 - 14 elements
Example:
[
  "https://example.com/input-1.jpg",
  "https://example.com/input-2.jpg"
]
​
size
string
default:2048x2048

Image size in format 'widthxheight'. Seedream 5.0 Lite supports custom 2K/3K resolutions.

Example:

"2304x1728"

​
sequential_image_generation
enum<string>
default:disabled

Batch generation mode. 'auto': model-controlled batch generation, 'disabled': generate single image only.

Available options:
auto,
disabled
Example:

"auto"

​
sequential_image_generation_max_images
integer
default:15

Maximum number of images for batch generation. This value is an upper limit, actual generated count may be less.

Required range: 1 <= x <= 15
Example:

3

​
optimize_prompt_mode
enum<string>
default:standard

Prompt optimization mode. Only 'standard' mode is supported.

Available options:
standard
Example:

"standard"

​
output_format
enum<string>
default:jpeg

Output image format. Supported values: 'jpeg' and 'png'.

Available options:
jpeg,
png
Example:

"png"

Response

200 - application/json

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required