Skip to main content
POST
/
api
/
v3
/
chat
/
completions
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": "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

ParameterTypeRequiredDefaultDescription
modelstring✅ Yesseedream-4-5-251128The 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❌ NourlResponse format: “url” (image URL) or “b64_json” (base64 encoded)
sizestring❌ No2048x2048Output image resolution. Options: 1024x1024, 1K, 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