> ## 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.

# Seededit-3-0-I2i-250628 - Image Edit

> Seededit-3-0-I2i-250628 — Image Edit. GPTProto API reference.

BytePlus's official format for the image edit API.

<CodeGroup>
  ```bash cURL theme={null}
  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
  }'
  ```

  ```python Python theme={null}
  import requests
  import json

  url = "https://gptproto.com/api/v3/images/generations"
  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
  }

  data = {
      "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 = requests.post(url, headers=headers, json=data)
  result = response.json()
  print(json.dumps(result, indent=2))
  ```

  ```javascript JavaScript theme={null}
  const url = "https://gptproto.com/api/v3/images/generations";
  const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  };

  const data = {
    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
  };

  fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(data)
  })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));
  ```

  ```go Go theme={null}
  package main

  import (
      "bytes"
      "encoding/json"
      "fmt"
      "io/ioutil"
      "net/http"
  )

  func main() {
      url := "https://gptproto.com/api/v3/images/generations"

      payload := []byte(`{
    "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
  }`)

      req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
      req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
      req.Header.Set("Content-Type", "application/json")

      client := &http.Client{}
      resp, err := client.Do(req)
      if err != nil {
          panic(err)
      }
      defer resp.Body.Close()

      body, _ := ioutil.ReadAll(resp.Body)
      fmt.Println(string(body))
  }
  ```
</CodeGroup>

<CodeGroup>
  ```json 400 - Bad Request theme={null}
  {
    "error": {
      "message": "Invalid request parameters",
      "type": "invalid_request_error",
      "code": "invalid_parameters"
    }
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "error": {
      "message": "Invalid authentication credentials",
      "type": "authentication_error",
      "code": "invalid_api_key"
    }
  }
  ```

  ```json 403 - Forbidden theme={null}
  {
    "error": {
      "message": "Insufficient permissions or quota exceeded",
      "type": "permission_error",
      "code": "insufficient_quota"
    }
  }
  ```

  ```json 429 - Rate Limit Exceeded theme={null}
  {
    "error": {
      "message": "Rate limit exceeded",
      "type": "rate_limit_error",
      "code": "rate_limit_exceeded"
    }
  }
  ```

  ```json 500 - Internal Server Error theme={null}
  {
    "error": {
      "message": "Internal server error",
      "type": "server_error",
      "code": "internal_error"
    }
  }
  ```
</CodeGroup>

## Parameters

| Parameter         | Type    | Required | Default                   | Description                                                             |
| ----------------- | ------- | -------- | ------------------------- | ----------------------------------------------------------------------- |
| `model`           | string  | ✅ Yes    | `seededit-3-0-i2i-250628` | The model identifier for image generation/editing                       |
| `prompt`          | string  | ✅ Yes    | -                         | Description of the desired image transformation or generation           |
| `image`           | string  | ✅ Yes    | -                         | Input image URL for image-to-image editing                              |
| `response_format` | string  | ❌ No     | `url`                     | Response format: "url" (image URL) or "b64\_json" (base64 encoded)      |
| `size`            | string  | ❌ No     | `adaptive`                | Output image resolution. Options: adaptive, 1024x1024, 2K, 4K           |
| `seed`            | integer | ❌ No     | -                         | Random seed for reproducible results                                    |
| `guidance_scale`  | number  | ❌ No     | `5.5`                     | Controls adherence to the prompt. Range: 1.0-10.0, recommended: 3.0-7.0 |
| `watermark`       | boolean | ❌ No     | `true`                    | Whether to add watermark to the generated image                         |