SeedEdit Image Editing
Use CometAPI POST /v1/images/edits for ByteDance SeedEdit (Seedream) image editing—apply prompt-guided edits, masks, and variations with fast outputs.
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form image='@example-file' \
--form 'prompt=Put on glasses'{
"model": "<string>",
"created": 123,
"data": [
{
"url": "<string>"
}
],
"usage": {
"generated_images": 123,
"output_tokens": 123,
"total_tokens": 123
}
}Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Edit images using ByteDance’s SeedEdit model through the standard OpenAI-compatible/v1/images/edits endpoint. Apply prompt-guided edits, masks, and variations.
For detailed parameter documentation, see the VolcEngine SeedEdit documentation.
When to use it
Use this endpoint when you already have an image and want to change part of it with a prompt. Typical cases include product image cleanup, background edits, local style changes, and prompt-guided variations.First request
Start with one source image and a direct edit prompt. Add a mask only after the basic edit works, because masks introduce another failure point in file upload, transparency, and alignment.Read the response
The API playground shows the exact response fields for generated images. Save the returned image URL or base64 payload according to your storage policy before you show it to users.Authorizations
Bearer token authentication. Use your CometAPI key.
Body
Incoming images need to fulfill the following conditions: Image format: jpeg, png. Aspect ratio (width/height): in the range (1/3, 3). Aspect length (px) > 14. Size: no more than 10MB.
A text description of the desired image(s).
- Max length: 1000 chars for dall-e-3, 32000 chars for gpt-image-1.
"Put on glasses"
Model to use: bytedance-seedEdit-3.0-i2i, doubao-seededit-3-0-i2i-250628, seedream-4-0-250828
"bytedance-seedEdit-3.0-i2i"
Response format. Options: "url" or "b64_json". Only "dall-e-3" supports "url" (valid for 60 minutes).
url, b64_json Output image size. Use adaptive to match the input image dimensions.
"adaptive"
Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation.
Controls how strongly the prompt influences the result vs. the input image. Range: 1.0–10.0. Higher values follow the prompt more closely.
When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form image='@example-file' \
--form 'prompt=Put on glasses'{
"model": "<string>",
"created": 123,
"data": [
{
"url": "<string>"
}
],
"usage": {
"generated_images": 123,
"output_tokens": 123,
"total_tokens": 123
}
}