Skip to main content
POST
/
api
/
v3
/
images
/
generations
seededit-3-0-i2i-250628 (image edit)
curl --request POST \
  --url https://api.example.com/api/v3/images/generations

Documentation Index

Fetch the complete documentation index at: https://docs.gptproto.com/llms.txt

Use this file to discover all available pages before exploring further.

BytePlus’s official format for the image edit API. 
curl -X POST "https://gptproto.com/api/v3/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seededit-3-0-i2i-250628",
  "prompt": "Change bubbles into heart shape",
  "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream_i2i.jpeg",
  "response_format": "url",
  "size": "adaptive",
  "seed": 21,
  "guidance_scale": 5.5,
  "watermark": true
}'

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameters"
  }
}

​
Parameters

ParameterTypeRequiredDefaultDescription
modelstring✅ Yesseededit-3-0-i2i-250628The model identifier for image generation/editing
promptstring✅ Yes-Description of the desired image transformation or generation
imagestring✅ Yes-Input image URL for image-to-image editing
response_formatstring❌ NourlResponse format: “url” (image URL) or “b64_json” (base64 encoded)
sizestring❌ NoadaptiveOutput image resolution. Options: adaptive, 1024x1024, 2K, 4K
seedinteger❌ No-Random seed for reproducible results
guidance_scalenumber❌ No5.5Controls adherence to the prompt. Range: 1.0-10.0, recommended: 3.0-7.0
watermarkboolean❌ NotrueWhether to add watermark to the generated image