curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "bytedance/seedream/v4.5/edit",
  "input": {
    "prompt": "Combine the three reference images into one natural photograph. Use the boy from image 1 with the same face, curly dark hair, freckles, red hooded raincoat with wooden toggles, navy trousers and yellow rubber boots. Use the exact toy sailboat from image 2: teal wooden hull with a white stripe, cream canvas sail with the stitched patch and dark blue painted star, red string at the bow. Place them on the misty loch shoreline from image 3. The boy crouches on the flat rocks at the water's edge, seen in three-quarter side view, gently setting the sailboat onto the calm water with both hands while holding the red string; small ripples spread around the hull. Keep the pebbles, rust bracken hills and misty pines of the location. Soft overcast morning light, consistent scale and shadows, realistic reflections in the water, a quiet tender moment, no text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "n": 1,
    "enable_safety_checker": true
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "GAPP1TYEWHR5CQVS",
    "status": "running",
    "created_time": "2026-09-25T16:16:53"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "model": "bytedance/seedream/v4.5/edit",
  "input": {
    "prompt": "Combine the three reference images into one natural photograph. Use the boy from image 1 with the same face, curly dark hair, freckles, red hooded raincoat with wooden toggles, navy trousers and yellow rubber boots. Use the exact toy sailboat from image 2: teal wooden hull with a white stripe, cream canvas sail with the stitched patch and dark blue painted star, red string at the bow. Place them on the misty loch shoreline from image 3. The boy crouches on the flat rocks at the water's edge, seen in three-quarter side view, gently setting the sailboat onto the calm water with both hands while holding the red string; small ripples spread around the hull. Keep the pebbles, rust bracken hills and misty pines of the location. Soft overcast morning light, consistent scale and shadows, realistic reflections in the water, a quiet tender moment, no text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "n": 1,
    "enable_safety_checker": true
  }
}
EOF

{
  "code": 200,
  "data": {
    "task_id": "GAPP1TYEWHR5CQVS",
    "status": "running",
    "created_time": "2026-09-25T16:16:53"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Seedream 4.5 Edit

Edit images with Seedream 4.5 using a text prompt and 1-10 reference images, generating 1-15 edited images per request.

Available Models

bytedance/seedream/v4.5/edit - Edit images using a prompt and image references.

Output Options

Image Size

size: Optional. Default: 1:1.
Presets: 2K, 4K, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9.
For custom dimensions, supply an object with integer width and height; both must be positive.
Custom dimensions also accept a WIDTHxHEIGHT string, using x or X between the positive dimensions.

Image Count

n: Optional. Number of images to generate. Integer from 1 to 15. Default: 1.

Key Features

Edit images using a prompt and image references.
Accepts 1-10 images in image_urls.
Control the number of output images with n.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Input image URLs use HTTP(S) and point to publicly accessible JPEG or PNG files.

Prompt

prompt: Required. Describe the requested changes. Length: 1-3,000 characters.
Include at least one non-whitespace character.

Image URLs

image_urls: Required. Provide publicly accessible image URLs. Supply 1-10 items. Each item must be an HTTP(S) URL pointing to a JPEG or PNG image.

Safety Checker

enable_safety_checker: Optional. Set true to enable the content safety check or false to disable it. Default: true.

Verified Example

This example was generated through the Vidgo test API with the basic request shown in the API playground. It combines three references in order: the child, the toy sailboat, and the lakeshore. The source and result images are hosted on the Vidgo CDN. Reference 1: child

{
  "code": 200,
  "data": {
    "task_id": "GAPP1TYEWHR5CQVS",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4.5/edit/v1/01/output.jpg",
        "file_type": "image"
      }
    ],
    "created_time": "2026-09-25T16:16:53",
    "error_message": null,
    "progress": 100
  }
}

Authorizations

Authorization

string

header

required

Use VIDGO_API_KEY.

Body

application/json

Set model and optional callback_url at the request root. Place generation parameters inside input.

model

enum<string>

required

Available options:

bytedance/seedream/v4.5/edit

Example:

"bytedance/seedream/v4.5/edit"

input

object

required

Show child attributes

callback_url

string | null

Optional public HTTP(S) URL for task completion notifications.

Response

Task submitted

code

enum<integer>

required

Available options:

200

data

object

required

Show child attributes

Overview

Chat Series

Image Series

Video Series

Music Series

3D Series

File Management

Task Management

Account Management

Seedream 4.5 Edit

Seedream 4.5 Edit

Available Models

Output Options

Image Size

Image Count

Key Features

Advanced Parameters

Prompt

Image URLs

Safety Checker

Verified Example

Authorizations

Body

Response

​Seedream 4.5 Edit

​Available Models

​Output Options

​Image Size

​Image Count

​Key Features

​Advanced Parameters

​Prompt

​Image URLs

​Safety Checker

​Verified Example

Authorizations

Body

Response

Seedream 4.5 Edit

Available Models

Output Options

Image Size

Image Count

Key Features

Advanced Parameters

Prompt

Image URLs

Safety Checker

Verified Example