X AI Grok Imagine Image V2.0 Text To Image API Documentation

X AI Grok Imagine Image V2.0 Text To Image API Documentation

Playground

xAI Grok Imagine Image V2.0 Text-to-Image generates high-quality images from text prompts, with configurable aspect ratio, resolution, and quality for creative visuals, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Grok Imagine Image V2.0 Text-to-Image generates high-quality images from natural-language prompts with configurable aspect ratio, resolution, and quality settings. It is well suited for creative generation, visual ideation, and production-ready image workflows.

Parameters

How to Use

1. Write a clear prompt describing the subject, composition, lighting, style, and any important visual details.
2. Choose an aspect ratio that fits your target layout.
3. Select the output resolution and quality tier.
4. Submit the request and retrieve the generated image URL.

Pricing

$0.05 per generated image, regardless of the selected resolution and quality. One image is generated per request.

Best Use Cases

• Creative image generation
• Marketing and social media visuals
• Concept art and visual ideation
• Portrait, product, and scene generation
• Fast iteration across quality and resolution tiers

Pro Tips

• Use detailed prompts for stronger composition and subject control.
• Choose 1k for faster iteration.
• Choose 2k when you need higher-resolution final output.
• Use medium quality for more polished results.
• Be specific about lighting, background, camera angle, and style when consistency matters.

Related Models

• Grok Imagine Image V2.0 Text-to-Image — Generate images from natural-language prompts.
• Grok Imagine Image V2.0 Edit — Edit images with text instructions.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "aspect_ratio": "1:1",
  "resolution": "2k",
  "quality": "medium"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-image-v2.0/text-to-image" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters