Images | Overview
AI image generation and editing API. Four models: Gemini 3 Pro, Gemini 3.1 Flash, Gemini 2.5 Flash, and Seedream V5 Lite. Text-to-image and multi-image editing.
Overview
The Images API provides AI-powered image generation and editing. Create images from text prompts or edit existing images with natural language instructions. All operations are asynchronous. Submit a request, receive a task ID, and poll for results.
Available Providers
| Provider | Capabilities | Credits |
|---|---|---|
| Gemini 3 Pro | Text-to-image, image editing. Resolutions up to 4K. Up to 4 images per request. | 50–80 per image (varies by resolution) |
| Gemini 3.1 Flash | Text-to-image, image editing. 512px to 4K resolution. Extended aspect ratios (1:4, 4:1, 1:8, 8:1). Up to 4 images per request. | 10–25 per image (varies by resolution) |
| Gemini 2.5 Flash | Text-to-image, image editing. Flat-rate pricing, no resolution tiers. Up to 4 images per request. | 5 per image |
| Seedream V5 Lite | Text-to-image, image editing. Named size presets (square, portrait, landscape, auto). Up to 6 images per request. Seed for reproducibility. | 10 per image |
How It Works
Submit a generation or edit request, then poll the status endpoint for results.
Request
# 1. Generate an image
curl -X POST https://api.3daistudio.com/v1/images/gemini/3/pro/generate/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "a sunset over mountains, photorealistic"}'
# 2. Poll for results
curl https://api.3daistudio.com/v1/generation-request/TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"Errors
Common errors for image endpoints.
| Status | Error Code | Description |
|---|---|---|
| 402 | insufficient_credits | Not enough credits. Top up your wallet. |
| 429 | rate_limited | Rate limit exceeded. Wait and retry. |
| 400 | validation_failed | Missing or invalid parameters. |