Use this in the request body model field.
imagen-4 API
Generate photorealistic images with Google's Imagen 4 API via API in One. 3 sub-models (fast/standard/ultra), 4–12 credits per image. Supports negative prompts, multi-image, and seeds.
The currently implemented BFF route.
Input types: text
Keys are managed by the shared dashboard.
Use callback_url on supported async tasks.
Live capabilities
These capabilities come from the current model config and backend route. Unreleased APIs are not listed.
Google-grade photorealism
3 quality tiers (fast/standard/ultra)
3 quality tiers (fast/standard/ultra)
Negative prompt support
Negative prompt support
Seed
Seed-based reproducibility
Request format
Clients call same-origin API routes; the server BFF forwards to the matching Worker.
POST/api/v1/images/generations8 creditsGoogle's Imagen 4 — photorealistic image generation with exceptional detail and prompt adherence.
Parameters
promptstringText description of the image
RequiredmodelstringSub-model: "imagen4-fast" (4cr), "imagen4" (8cr), or "imagen4-ultra" (12cr)
Optional · Default imagen4aspect_ratiostringAspect ratio: 1:1, 4:3, 3:4, 16:9, 9:16
Optional · Default 1:1negative_promptstringElements to avoid in the generated image
Optionalnum_imagesnumberNumber of images to generate
Optional · Default 1seednumberRandom seed for reproducibility
OptionalExample request
curl -X POST https://apiin.one/api/v1/images/generations \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "imagen4",
"prompt": "A photorealistic bowl of ramen with steam rising, side lighting, food photography",
"aspect_ratio": "1:1"
}'Models on the same endpoint
These live models use the same implemented BFF endpoint and can be switched by changing the model field.
/api/v1/images/generations/api/v1/images/generations
grok-imagineimage · 5 credits/api/v1/images/generations
kling-image-o1image · 6 credits/api/v1/images/generations✦ideogram-v3image · 8 credits/api/v1/images/generations🤖gpt-image-1.5-officialimage · 10 credits/api/v1/images/generationsIntegration flow
These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.
Create a shared API key
Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.
Call the real endpoint
Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations
Poll task status
Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.
Task status route
After creating image, video, audio, or tool tasks, poll the real task endpoint for results.
GET/api/v1/tasks/{task_id}Check generation task status and result.Pricing
4–12 credits per image (~$0.04–$0.12)
Use cases
These workflows are supported by the current model and backend node.
Generate photorealistic product imagery
Create high-quality stock photography alternatives
Build design tools with Google-quality image generation
Produce marketing visuals with precise prompt control
FAQ
How much does Imagen 4 cost?
Depends on sub-model: imagen4-fast costs 4 credits, imagen4 (standard) costs 8 credits, imagen4-ultra costs 12 credits.
Do I need a Google Cloud account?
No. API in One handles all authentication. No GCP project or billing setup needed.
Can I generate multiple images?
Yes. Set num_images to generate multiple images per request (each consumes credits independently).