Grok Imagine Series

POST

tasks

Grok Imagine Series

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "n": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "quality": "<string>",
  "image_urls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "quality": "<string>",
    "image_urls": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    n: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    quality: '<string>',
    image_urls: ['<string>']
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

The xAI Grok Imagine image line currently offers six model IDs. All of them are submitted through the unified task endpoint POST /v1/tasks and all of them settle at a fixed price per successfully generated image — switching tiers only changes model. On the official route, grok-imagine-image, grok-imagine-image-quality and grok-imagine-image-2.0 support reference-image editing and resolution selection, and charge separately for each reference image. The economy models grok-imagine-image-2.0-rev, grok-imagine-1.5-rev and grok-imagine-1.5-edit-rev take fewer parameters, output at a fixed tier, and cost less. For video, see Grok Imagine Video Series.

Quick start

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-image-001" \
  -d '{
    "model": "grok-imagine-image",
    "action": "generate",
    "prompt": "A white ceramic cup on an oak table, soft studio light, product photography",
    "aspect_ratio": "1:1",
    "resolution": "2k",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-image-edit-001" \
  -d '{
    "model": "grok-imagine-image",
    "action": "edit",
    "prompt": "Keep the subject, change the background to a beach at sunset",
    "image_urls": ["https://cdn.example.com/source.png"],
    "resolution": "1k",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "action": "edit",
    "prompt": "Use the product from the first image in the poster style of the second",
    "image_urls": [
      "https://cdn.example.com/product.png",
      "https://cdn.example.com/style.webp"
    ],
    "aspect_ratio": "4:3",
    "resolution": "2k",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "action": "generate",
    "prompt": "A city street after rain, neon reflections, cinematic",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "quality": "medium",
    "n": 1
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5-rev",
    "action": "generate",
    "prompt": "A shiba inu in an astronaut helmet floating in space, cartoon style",
    "aspect_ratio": "16:9",
    "n": 2
  }'

A successful submission returns a task_id. Retrieve the result with GET /v1/tasks/{task_id}, wait inline with Prefer: wait, or configure a webhook.

Request parameters

string

required

One of six IDs; see Available models.

string

default:"generate"

generate — generate from text
edit — rewrite from reference images; image_urls is required

Single-image editing and multi-reference blending both use edit; the only difference is how many entries image_urls carries. grok-imagine-image-2.0-rev and grok-imagine-1.5-rev support generate only.

string

required

Image description or editing instruction, in English or Chinese.

integer

default:"1"

Number of images to return. grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0, grok-imagine-1.5-rev and grok-imagine-1.5-edit-rev accept 1–10; grok-imagine-image returns one image under edit. grok-imagine-image-2.0-rev accepts 1–12.

string

default:"auto"

Frame ratio; the accepted set differs by model, see Available models. grok-imagine-image, grok-imagine-image-quality and grok-imagine-image-2.0 default to auto, letting the model choose the framing; grok-imagine-image-2.0-rev defaults to 1:1. grok-imagine-1.5-edit-rev does not accept this parameter.

string

default:"1k"

Output resolution, 1k or 2k. Only grok-imagine-image, grok-imagine-image-quality and grok-imagine-image-2.0 accept it; the other three models output at a fixed tier.

string

Quality tier, low or medium. Only grok-imagine-image-2.0 accepts it, and only under action: "generate" — do not send it with reference images. Without it, pricing follows the resolution tier.

string[]

Reference image URLs, publicly reachable. Required for edit: grok-imagine-image takes 1–5, grok-imagine-image-quality and grok-imagine-image-2.0 take 1–3, grok-imagine-1.5-edit-rev takes 1–5. grok-imagine-1.5-rev also accepts reference images under generate, up to 5; grok-imagine-image-2.0-rev does not accept them.Array order is preserved for multi-reference requests, so the prompt can refer to the first image, the second image, and so on.

See Submit Task for callback_url, callback_events, Prefer: wait, Idempotency-Key and the maximum-cost header. seed and mask_url are not supported. Any other parameter returns 400 and is not billed.

Limits

Model	Condition	Limit
`grok-imagine-image`	Per request	Generation accepts 1 to 10 output images per request
`grok-imagine-image`	`action: "generate"`	Text-to-image does not take reference images; use edit
`grok-imagine-image`	`action: "edit"`	Editing requires 1 to 5 reference images and returns one image
`grok-imagine-image-quality`	Per request	1 to 10 output images per request
`grok-imagine-image-quality`	`action: "generate"`	Text-to-image does not take reference images; use edit
`grok-imagine-image-quality`	`action: "edit"`	Edit takes 1-3 reference images (one edits that image, several act as multi-image references)
`grok-imagine-image-2.0`	Per request	1 to 10 output images per request
`grok-imagine-image-2.0`	`action: "generate"`	Text-to-image does not take reference images; use the edit action
`grok-imagine-image-2.0`	`action: "edit"`	Editing needs 1 to 3 reference images
`grok-imagine-image-2.0`	`action: "edit"`	Quality cannot be chosen when editing with reference images
`grok-imagine-image-2.0-rev`	Per request	1 to 12 images per request
`grok-imagine-image-2.0-rev`	`action: "generate"`	This route is text-to-image only
`grok-imagine-1.5-rev`	Per request	Up to 10 images per request
`grok-imagine-1.5-edit-rev`	Per request	Up to 10 images per request

Pricing

All six models settle at a fixed price per successfully generated image. generate and edit cost the same, and neither aspect ratio nor prompt length affects the price. The billing dimensions differ by model:

Model	Billing dimensions
`grok-imagine-image`	One price per image, the same at `1k` and `2k`; each reference image is charged separately
`grok-imagine-image-quality`	Priced by resolution, `2k` above `1k`; each reference image is charged separately
`grok-imagine-image-2.0`	Priced by resolution × quality (`1k` / `2k` × `low` / `medium`); without `quality`, the resolution tier applies; each reference image is charged separately, once per request
`grok-imagine-image-2.0-rev`	One price per image
`grok-imagine-1.5-rev`	One price per image; reference images add no fee
`grok-imagine-1.5-edit-rev`	One price per image; reference images add no fee

With reference images, a call to grok-imagine-image or grok-imagine-image-quality costs (resolution tier price + per-reference-image price × number of reference images) × number of output images; on grok-imagine-image-2.0 the reference-image fee is not repeated per output, so a call costs resolution tier price × number of output images + per-reference-image price × number of reference images. A resolution outside the tiers a model supports settles at its fallback price, equal to the 1k tier. Rates are in price_config on GET /v1/models and in the console’s Model Market. What a single call actually cost is the cost field on the task response — an integer quota at 500,000 quota = 1 USD, not dollars. You are only billed for a successfully generated image. Failed and cancelled tasks, and tasks that return no usable image, are refunded in full.

Response

Completed task

{
  "task_id": "task-wave1775290140a830128812",
  "model": "grok-imagine-image",
  "action": "edit",
  "status": "completed",
  "progress": "100%",
  "created_at": 1775290140,
  "completed_at": 1775290196,
  "billing_status": "settled",
  "cost": 9900,
  "result": {
    "images": [
      {
        "expires_at": 1775376540,
        "url": ["https://cdn.example.com/result.jpg"]
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775290140a830128812",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775290140a830128812/cancel"
  }
}

result.images carries the generated images, with one entry per image when n is greater than 1. Image links expire, so store them once retrieved. Full field reference: Query Task Status.

Available models

Model ID	Actions	Aspect ratios	Resolution / quality	Reference images
`grok-imagine-image`	`generate` / `edit`	14	`1k` `2k`	1–5, charged per image
`grok-imagine-image-quality`	`generate` / `edit`	14	`1k` `2k`	1–3, charged per image
`grok-imagine-image-2.0`	`generate` / `edit`	14	`1k` `2k` × `low` `medium`	1–3, charged per image
`grok-imagine-image-2.0-rev`	`generate`	7	Fixed	Not supported
`grok-imagine-1.5-rev`	`generate`	5	Fixed	Up to 5, no extra fee
`grok-imagine-1.5-edit-rev`	`generate` / `edit`	Not selectable	Fixed	Up to 5, no extra fee

Aspect ratio sets:

14 (grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0): auto, 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1
7 (grok-imagine-image-2.0-rev): 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9
5 (grok-imagine-1.5-rev): 1:1, 16:9, 9:16, 3:2, 2:3

Grok Imagine Series

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "n": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "quality": "<string>",
  "image_urls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "quality": "<string>",
    "image_urls": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    n: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    quality: '<string>',
    image_urls: ['<string>']
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"quality\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Account & Usage

Grok Imagine Series

Quick start

Request parameters

Limits

Pricing

Response

Available models

​Quick start

​Request parameters

​Limits

​Pricing

​Response

​Available models

​Related

Quick start

Request parameters

Limits

Pricing

Response

Available models

Related