Skip to main content
POST
https://gptproto.com
/
api
/
v3
/
images
/
generations
seedream-5-0-260128 (Image Edit)
curl --request POST \
  --url https://gptproto.com/api/v3/images/generations

​
Authentication

  1. Sign up for a GPTProto account at https://gptproto.com
  2. Navigate to the API Keys section in your dashboard
  3. Generate a new API key (sk-xxxxx)
  4. Copy and securely store your API key For authentication details, please refer to the Authentication section.

​
Initiate Request

curl --location 'https://gptproto.com/api/v3/images/generations' \
--header 'Authorization: GPTPROTO_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "model": "seedream-5-0-260128",
  "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,
  "watermark": true
}'

​
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
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

​
Error Codes

​
Common Error Codes

Error CodeError NameDescription
401UnauthorizedAPI key is missing or invalid
403ForbiddenYour API key doesn’t have permission to access this resource, or insufficient balance for the requested operation
429Too Many RequestsYou’ve exceeded your rate limit
500Internal server errorAn internal server error occurred
503Content policy violationContent blocked due to safety concerns (actual status code is 400)