Skip to main content
POST
Submit Seedream 5.0 Flash Image Edit Task
  1. Submit the request with VIDGO_API_KEY. A task_id is returned. Keep it until the task reaches finished or failed.
  2. 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 5.0 Flash Image Edit

Usage Guide

Edit one image with Seedream 5.0 Flash using text instructions and reference images.
  • Set model to bytedance/seedream-v5.0-flash/edit.
  • Place model and optional callback_url at the request root; place workflow parameters inside input.
  • Each request produces one image.
  • For prompt-only generation, use Text to Image with model=bytedance/seedream-v5.0-flash/text-to-image.

Parameter Details

  • prompt is required. Supply non-blank text of up to 5,000 characters.
  • image_urls is required and accepts 1 to 10 reference image URLs. Use publicly accessible HTTP(S) URLs in the same order as the references in your prompt.

Developer Notes

  • Submission is asynchronous. Use the task status endpoint or a completion webhook to retrieve the final image.
  • Billing is per output image. Text-to-image and editing use the same rate across the supported resolution tiers.
  • Credits are deducted on submission and refunded if the task fails.

Optional parameters

  • size (string): Output aspect ratio. Accepted values: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9. Default: 1:1.
  • resolution (string): Output resolution tier. Accepted values: 1K, 1.5K, 2K. Default: 1K.
  • output_format (string): Output image format. Accepted values: jpeg, png. If omitted, the format is selected by the upstream model.
  • enable_safety_checker (boolean): Enable content safety checking. Default: true.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer VIDGO_API_KEY.

Body

application/json
model
string
required
Example:

"bytedance/seedream-v5.0-flash/edit"

input
object
required
callback_url
string<uri>

Optional webhook URL for completion or failure notifications.

Example:

"https://your-domain.com/callback"

Response

Task submission result. A task ID identifies asynchronous work; generation may still be running.

code
integer
required
Example:

200

data
object
required