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.
Model ID
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
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"
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"
]
}
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
}
