Model ID

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:

Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Endpoint

POST /api/v1/apikey/requests

Request Format

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

{
  "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

curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "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

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

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

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "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

Use descriptive prompts: e.g., “cinematic portrait with warm lighting and shallow depth of field”
Lower guidance_scale (5–7) for subtle, realistic edits
Higher guidance_scale (8–10) for strong artistic transformations
Set seed to reproduce identical results
Disable watermark (add_watermark=false) for raw creative assets
Ensure image URLs are accessible via HTTPS

Parameter Examples

Cinematic Portrait

{
  "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

{
  "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

{
  "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
}

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

seededit-3-0-i2i-250628

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

Overview

Key Features:

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Image Specifications

Tips for Better Results

Parameter Examples

Cinematic Portrait

Artistic Style Transfer

Lighting Enhancement

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

​Overview

​Key Features:

​Authentication

​Submit Video Generation Request

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Pricing

​Image Specifications

​Tips for Better Results

​Parameter Examples

​Cinematic Portrait

​Artistic Style Transfer

​Lighting Enhancement

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

Overview

Key Features:

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Image Specifications

Tips for Better Results

Parameter Examples

Cinematic Portrait

Artistic Style Transfer

Lighting Enhancement