Skip to main content
POST
/
api
/
v3
/
chat
/
completions
doubao-seedream-4-5-251128 (image edit)
curl --request POST \
  --url https://api.example.com/api/v3/chat/completions
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": "doubao-seedream-4-5-251128",
  "prompt": "Change bubbles into heart shape",
  "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream_i2i.jpeg",
  "response_format": "url",
  "size": "2k",
  "seed": 21,
  "guidance_scale": 5.5,
  "watermark": true
}'

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

​
Parameters

ParameterTypeRequiredDefaultRangeDescription
modelstring✅ Yesdoubao-seedream-4-5-251128-The 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 generation
response_formatstring❌ Nourl-Response format: “url” (image URL) or “b64_json” (base64 encoded)
sizestring❌ Noadaptive-Output image resolution. Options: adaptive, 1024x1024, 2K, 4K
seedinteger❌ No--Random seed for reproducible results
guidance_scalenumber❌ No5.51.0-10.0Controls adherence to the prompt. Recommended: 3.0-7.0
watermarkboolean❌ Notrue-Whether to add watermark to the generated image