# Grok Imagine Image 2.0 - Core.Today AI API

> xAI's newest Grok Imagine image model, served over the direct xAI API. Strong at precise compositions - infographics, ads, game assets, UI/UX mockups, and storyboards.

- **Provider**: xAI
- **Model ID**: xai/grok-imagine-image-2.0
- **Category**: Image Generation
- **Credits**: 140 per image
- **Speed**: Fast
- **Quality**: High

## Features
- Latest Grok Imagine image generation model
- Precise layout control for infographics, ads, and mockups
- Up to 10 images per request (billed per image)
- 14 aspect ratio presets plus auto
- 1k / 2k output resolution tiers (2k billed higher)

## Use Cases
- Marketing visuals and ad creatives with exact composition
- Game asset and storyboard concept generation
- UI/UX mockups and product infographics

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text prompt for image generation.

### Optional
- **n**: integer (default: 1) - Number of images to generate (1-10). Billed per image.
- **aspect_ratio**: string (default: auto) - Aspect ratio of the generated image.
  Options: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
- **resolution**: string - Output resolution tier. 2k is billed at a higher rate; omitted defaults to 1k.
  Options: 1k, 2k

## Examples

### Infographic
Precise isometric infographic
```json
{
  "model": "xai/grok-imagine-image-2.0",
  "input": {
    "prompt": "A clean isometric infographic of a coffee brewing process, labeled steps, pastel palette, vector-like precision",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Text-heavy layouts benefit from 2k, billed at a higher rate (186 vs 140 credits)
- For editing an existing image, use xai/grok-imagine-image-2.0/edit
- Batch up to 10 variations in one request with the n parameter