> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# seededit-3-0-i2i-250628

> API usage guide for seededit-3-0-i2i-250628.

{/* source_model_id: seededit-3-0-i2i-250628 */}

{/* source_updated_at: 1759790703 */}

**Model ID**

```bash theme={null}
seededit-3-0-i2i-250628
```

**Calling method:** sync

# SeedEdit-3-0-i2i-250628 API Usage Guide

## Overview

**SeedEdit-3-0-i2i-250628** is an advanced image-to-image (I2I) editing model that enables high-quality transformations of input images using natural language prompts. It supports fine-grained control over style, lighting, and semantic structure while preserving the subject’s original composition. Designed for creative editing, stylization, and realistic retouching, SeedEdit offers a balance of precision and artistic flexibility.

### Key Features:

* **High-Fidelity Image Editing**: Maintains subject realism while applying expressive transformations
* **Prompt-Guided Control**: Edit lighting, composition, or mood through natural language
* **Reproducibility**: Generate consistent results using a random seed
* **Optional Watermarking**: Embed watermark for brand-safe outputs
* **Fast Inference**: Optimized for real-time generation on GMI Cloud’s GPU clusters

***

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Video Generation Request

### Endpoint

```
POST /api/v1/apikey/requests
```

### Request Format

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seededit-3-0-i2i-250628",
    "payload": {
      "image": "https://example.com/source.jpg",
      "prompt": "A cinematic portrait of a woman with dramatic lighting and soft shadows",
      "guidance_scale": 7.5,
      "seed": 123456,
      "add_watermark": true,
      "response_format": "url"
    }
  }'

```

### Request Parameters

| Parameter                 | Type    | Required | Description                           | Default | Constraints                                  |
| ------------------------- | ------- | -------- | ------------------------------------- | ------- | -------------------------------------------- |
| `model`                   | string  | Yes      | Model identifier                      | -       | Must be `"seededit-3-0-i2i-250628"`          |
| `payload.image`           | string  | Yes      | URL or Base64-encoded input image     | -       | Must be accessible via HTTPS or valid Base64 |
| `payload.prompt`          | string  | Yes      | Text prompt describing desired edit   | -       | Required                                     |
| `payload.guidance_scale`  | float   | No       | Prompt adherence strength (CFG scale) | `7.5`   | Range: 1–15                                  |
| `payload.seed`            | integer | No       | Random seed for reproducible results  | Random  | Positive integer                             |
| `payload.add_watermark`   | boolean | No       | Whether to add a GMI watermark        | `true`  | `true` / `false`                             |
| `payload.response_format` | string  | No       | Output format for generated image     | `"url"` | Options: `url`, `base64`, `json`             |

### Response

```json theme={null}
{
  "request_id": "6c96fe63-d1ca-4dc1-90c5-c866bbbd9521",
  "model": "seededit-3-0-i2i-250628",
  "status": "queued",
  "created_at": 1761763441,
  "updated_at": 1761763441,
  "queued_at": 1761763441
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/apikey/requests/{request_id}
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "request_id": "6c96fe63-d1ca-4dc1-90c5-c866bbbd9521",
  "org_id": "cbbb8914-5ff2-4fa3-977c-214b90d9dd9d",
  "model": "seededit-3-0-i2i-250628",
  "status": "success",
  "payload": {
    "add_watermark": true,
    "guidance_scale": 7.5,
    "image": "https://example.com/source.jpg",
    "prompt": "A cinematic portrait of a woman with dramatic lighting and soft shadows",
    "response_format": "url",
    "seed": 123456
  },
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-video-assests-prod/user-assets/cbbb8914-5ff2-4fa3-977c-214b90d9dd9d/1bd73ebe-2ad9-40c9-89c8-dc64204e7106/gmi-videogen/generated/source_image_6c96fe63-d1ca-4dc1-90c5-c866bbbd95216eca5274-4901-48b4-a812-5e0882983f8f.jpg"
      }
    ],
    "usage": {
      "generated_images": 1,
      "output_tokens": 4056,
      "total_tokens": 4056
    }
  },
  "created_at": 1761763441,
  "updated_at": 1761763451,
  "queued_at": 1761763441
}

```

## Request Status Values

| Status       | Description                             |
| ------------ | --------------------------------------- |
| `queued`     | Request is waiting to be processed      |
| `processing` | Image generation is in progress         |
| `success`    | Image generation completed successfully |
| `failed`     | Image generation failed                 |
| `cancelled`  | Request was cancelled                   |

## List Your Requests

### Endpoint

```
GET /api/v1/apikey/requests?model_id=seededit-3-0-i2i-250628
```

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=seededit-3-0-i2i-250628" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/seededit-3-0-i2i-250628
```

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/seededit-3-0-i2i-250628" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## List Available Models

### Endpoint

```
GET /api/v1/apikey/models
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "model_ids": [
    "seededit-3-0-i2i-250628",
    "other-model-1",
    "other-model-2"
  ]
}
```

## Pricing

* **Pricing Type**: Per-image request
* **Price**: \$0.05 per image
* **Unit**: Image

Example cost calculation:

* 1 image = \$0.05
* 10 images = \$0.50
* 100 images = \$5.00

## Image Specifications

* **Resolution**: Up to 1024×1024 pixels
* **Format**: PNG or JPEG
* **Output**: Downloadable via signed URL
* **Watermark**: Optional (default: false)

## Tips for Better Results

1. Use descriptive prompts: e.g., “cinematic portrait with warm lighting and shallow depth of field”

2. Lower guidance\_scale (5–7) for subtle, realistic edits

3. Higher guidance\_scale (8–10) for strong artistic transformations

4. Set seed to reproduce identical results

5. Disable watermark (add\_watermark=false) for raw creative assets

6. Ensure image URLs are accessible via HTTPS

## Parameter Examples

### Cinematic Portrait

```json theme={null}
{
  "image": "https://example.com/portrait.jpg",
  "prompt": "A cinematic portrait with soft light and shallow depth of field",
  "guidance_scale": 7.5,
  "seed": 12345,
  "add_watermark": false
}
```

### Artistic Style Transfer

```json theme={null}
{
  "image": "https://example.com/sketch.jpg",
  "prompt": "Transform this sketch into a realistic oil painting with vibrant colors",
  "guidance_scale": 9.0,
  "add_watermark": true
}
```

### Lighting Enhancement

```json theme={null}
{
  "image": "https://example.com/interior.jpg",
  "prompt": "Enhance indoor lighting for a cinematic atmosphere with warm tones",
  "guidance_scale": 6.5,
  "seed": 67890,
  "add_watermark": false
}
```