Image APIActive

grok-imagine API

Generate and upscale images with xAI's Grok Imagine via API in One. Text-to-image (5 credits), image upscale (12 credits). No X/Twitter subscription needed.

Get API Key View Docs

Model IDgrok-imagine

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookSupported

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.

No X/Twitter Premium subscription needed

Direct API access to xAI's Grok Imagine

Fast generation speed

Built

Built-in upscale mode

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/images/generations5 credits

xAI's Grok Imagine — powerful AI image generation and upscaling from the creators of Grok. Fast, high-quality, and unrestricted.

Parameters

promptstring

Text prompt for image generation (max 5000 chars)

Required

modelstring

Sub-model: "grok-imagine/text-to-image" (5cr) or "grok-imagine/upscale" (12cr)

Optional · Default grok-imagine/text-to-image

task_idstring

Task ID for upscale mode (upscale a previously generated image)

Optional

Example 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": "grok-imagine/text-to-image",
  "prompt": "An astronaut riding a horse on Mars, photorealistic"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

🧠cogview-4image · 4 credits/api/v1/images/generations

flux-2image · 5 credits/api/v1/images/generations

kling-image-o1image · 6 credits/api/v1/images/generations✦ideogram-v3image · 8 credits/api/v1/images/generations🌐imagen-4image · 8 credits/api/v1/images/generations🤖gpt-image-1.5-officialimage · 10 credits/api/v1/images/generations

Integration 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

5–12 credits per request (~$0.05–$0.12)

Base cost$0.05

Credits5

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

Generate creative and unrestricted AI imagery

Upscale AI-generated images for higher resolution

Build AI art generation features into apps

Create marketing and social media visuals

FAQ

How much does Grok Imagine cost?

Text-to-image: 5 credits (~$0.05), upscale: 12 credits (~$0.12).

What modes does Grok Imagine support?

Two image modes: text-to-image and upscale. For video generation, see Grok Video.

Do I need a Twitter/X Premium subscription?

No. API in One provides direct API access without any X/Twitter subscription.