Skip to main content
POST
/
api
/
v1
/
task
/
submit
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine/text-to-image-lite",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cyberpunk samurai in neon Tokyo rain",
    "n": 2
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.maxapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Generate images from text using xAI’s Grok Imagine. Three tiers differ in quality, batch size, and pricing. Grok Imagine is known for minimal content restrictions.

​
Available Models

grok-imagine/text-to-image-lite · grok-imagine/text-to-image-standard · grok-imagine/text-to-image-pro

​
Tier Comparison

Cheapest tier
  • Price: $0.001 per image
  • n range: 1-4
  • Output dimensions are inferred by Grok from the prompt content (e.g. “wide landscape” produces a landscape image; “tall portrait” produces a portrait one). Does not accept ratio / resolution parameters — describe the orientation in the prompt instead.
  • Best for: drafts, high-volume exploration
Balanced tier
  • Price: $0.0012 per image
  • n range: 1-10
Highest quality
  • Price: $0.0015 per image
  • n range: 1-10
​
model
string
required
One of grok-imagine/text-to-image-lite, grok-imagine/text-to-image-standard, grok-imagine/text-to-image-pro.
​
callBackUrl
string
Webhook callback URL.
​
input
object
required
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine/text-to-image-lite",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "A cyberpunk samurai in neon Tokyo rain",
    "n": 2
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
Query Result

Retrieve the result via the Query Task endpoint or Webhook. 
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "SUCCESS",
    "input": {
      "model": "grok-imagine/text-to-image-pro",
      "prompt": "Portrait of an astronaut drinking tea",
      "ratio": "1:1"
    },
    "result": {
      "type": "image",
      "urls": ["https://cdn.maxapi.io/images/.../image-0.jpg"]
    }
  }
}
Average generation time: 5-20 seconds. Each result URL is hosted on Max API’s CDN.