Skip to main content
POST
/
v1
/
images
/
generations
Image to Image
curl --request POST \
  --url https://gptproto.com/v1/images/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "<string>",
  "prompt": "<string>",
  "image": "<string>",
  "response_format": "<string>",
  "size": "<string>",
  "seed": 123,
  "guidance_scale": 123,
  "watermark": true
}'
{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}

​
Overview

This endpoint provides image to image functionality.

​
Authentication

This endpoint requires authentication using a Bearer token.
​
Authorization
string
default:"sk-***********"
required
Your API key in the format: YOUR_API_KEY

​
Request Body

​
model
string
default:"seededit-3-0-i2i-250628"
required
The model to use for the request
​
prompt
string
default:"Change bubbles into heart shape"
required
Image generation prompt describing the desired image content
​
image
string
Input image URL(s) for image-to-image generation
​
response_format
string
default:"url"
Response format: “url” (image URL) or “b64_json” (base64 encoded)
​
size
string
default:"adaptive"
Output image resolution (e.g., 1024x1024, 2K, 4K)
​
seed
integer
default:"21"
Random seed for reproducible results
​
guidance_scale
number
default:"5.5"
Controls how closely the image follows the prompt (higher = more strict, typical range: 1.0-7.0)
​
watermark
boolean
default:"true"
Whether to add watermark to generated image

​
Request Example

curl -X POST "https://gptproto.com/v1/images/generations" \
  -H "Authorization: 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
}'

​
Response

​
Success
200
Successful response
{
  "status": "success"
}

​
Error Responses

{
  "error": {
    "message": "Invalid signature",
    "type": "401"
  }
}