Seedream v5.0 Pro Edit

Model ID bytedance/seedream-v5.0-pro/edit

Overview

Image editing from 1 to 10 references, with optional transparent PNG output.

ByteDance · image-to-image

Endpoint

POST /v1/images/generations/async

Authentication

Authorization: Bearer <AIAPIAIAPI_API_KEY>

Request Body

model

Type: string · Required: Yes · Nullable: No

Model ID used to route the request.

prompt

Type: string · Required: Yes · Nullable: No

Positive prompt; under 600 English words is recommended.

images

Type: array · Required: Yes · Nullable: No

1–10 reference images. Supported formats: JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC and HEIF. The first reference is free at the provider; additional references cost extra.

size

Type: string · Required: No · Nullable: No

Output dimensions from the supported presets. Up to 2.61 million output pixels uses the provider's 1.5K tier; larger sizes use the 2K tier.

thinking

Type: string · Required: No · Nullable: No

Enable or disable deep thinking during prompt optimization.

prompt_optimization_mode

Type: string · Required: No · Nullable: No

Prompt optimization mode; fast reduces latency. Both modes have the same provider price.

output_format

Type: string · Required: No · Nullable: No

Output file format.

background

Type: string · Required: No · Nullable: No

Transparent output requires output_format=png and exactly one source PNG carrying an alpha channel. The provider validates the input image format and alpha channel.

Request Example

curl --request POST \
  --url https://aiapiaiapi.com/v1/images/generations/async \
  --header 'Authorization: Bearer $AIAPIAIAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
      "model": "bytedance/seedream-v5.0-pro/edit",
      "prompt": "A cinematic camera movement through a forest",
      "images": ["https://example.com/reference.jpg"]
    }'

JSON

{
  "model": "bytedance/seedream-v5.0-pro/edit",
  "prompt": "A cinematic camera movement through a forest",
  "images": ["https://example.com/reference.jpg"]
}

Response

{
  "code": "success",
  "message": "",
  "data": { "task_id": "image_01K2ABC123" }
}

Task Status

Use the task_id from the create response:

GET /v1/images/generations/async/{task_id}

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "image_01K2ABC123",
    "status": "SUCCESS",
    "progress": "100%",
    "outputs": ["https://cdn.example.com/images/image_01K2ABC123.png"],
    "start_time": 1786960805,
    "finish_time": 1786960900,
    "submit_time": 1786960800,
    "fail_reason": ""
  }
}

Error Responses

Validation errors return HTTP 400 with a stable error code.

{
  "code": "unsupported_parameter",
  "message": "The parameter is not supported by this model.",
  "data": null
}