Grok Image API (grok-imagine-1.5-apimart)

Grok Image on APIMart is the async Grok Imagine route: text-to-image plus reference-based editing, five aspect ratios, and up to 10 images per request — the batch behaviour is the unusual part.

Attributed entry points: Open Grok Image on APIMart · Current pricing · Get an API key

Model id and routes

Route	model value	Billing	Notes
Per-image (default here)	grok-imagine-1.5-apimart	per delivered image, by resolution	alias grok-imagine-1.5-ext is documented as equivalent
Token-billed official	``	per million tokens	no official_fallback on this id

Endpoint: POST https://api.apimart.ai/v1/images/generations (OpenAI-compatible), then poll GET /v1/tasks/{task_id}. Result links are valid for 24 hours.

Pricing

Output	List price	Effective price
default	$0.0187	$0.015

Prices are a snapshot; the pricing page and data/model.json are refreshed by CI, and a completed task reports the exact amount in its cost field.

Request parameters

Field	Type	Default	Notes
model	string	required	grok-imagine-1.5-apimart (alias grok-imagine-1.5-ext); the sibling ids grok-imagine-image and grok-imagine-image-quality are documented on the same endpoint
prompt	string	required	supports multiple languages; describes the image or the edit
size	string	1:1	1:1, 16:9, 9:16, 3:2, 2:3
n	integer	1	1–10 images per request on this route; must be a plain number
image_urls	string[]	—	1–5 publicly reachable reference URLs for editing; local files must be uploaded first
nsfw_check	boolean	false	runs omni-moderation-latest before submitting

Supported aspect ratios: 1:1, 16:9, 9:16, 3:2, 2:3.

Quickstart

curl --request POST --url https://api.apimart.ai/v1/images/generations \
  --header "Authorization: Bearer $APIMART_API_KEY" --header 'Content-Type: application/json' \
  -d '{"model":"grok-imagine-1.5-apimart","prompt":"A bamboo forest path under moonlight","size":"1:1","resolution":"1K","n":1}'

import os, time, requests

BASE = "https://api.apimart.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}", "Content-Type": "application/json"}

created = requests.post(f"{BASE}/images/generations", headers=HEADERS, timeout=60, json={
    "model": "grok-imagine-1.5-apimart", "prompt": "A bamboo forest path under moonlight",
    "size": "1:1", "resolution": "1K", "n": 1,
}).json()
task_id = created["data"]["id"]

while True:
    task = requests.get(f"{BASE}/tasks/{task_id}", headers=HEADERS, timeout=60).json()["data"]
    if task["status"] in ("completed", "failed"):
        break
    time.sleep(5)
print(task.get("cost"), task.get("result", {}).get("images", [{}])[0].get("url"))

const res = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.APIMART_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "grok-imagine-1.5-apimart", prompt: "A bamboo forest path under moonlight",
                          size: "1:1", resolution: "1K", n: 1 }),
});
const { data } = await res.json();      // data.id is the task id — poll /v1/tasks/<id>

Runnable versions: examples/. The task lifecycle is pending → processing → completed | failed, and the finished task carries cost, credits_cost and expiring result URLs.

Sample outputs

Every render below came from a single call with the model id above, at the ratio shown; the cost column is what the task reported.

Output	Recipe	Ratio	Cost	Prompt
	Product	1:1	$0.015	Two frosted glass cosmetics bottles on a pale sand surface, hard afternoon light casting long shadows, minimal styling, commercial product photography
	Cinematic	16:9	$0.015	Cyberpunk motorbike parked in a neon-lit underpass, rain on asphalt, magenta and cyan rim lights, cinematic still, shallow depth of field
	Concept art	3:2	$0.015	Mythic forest creature concept art, antlered guardian covered in moss and small flowers, soft volumetric light through trees, painterly detail
	Poster / graphic	3:4	$0.015	Retro travel poster illustration of a coastal train route, flat colour blocks, textured paper grain, warm sunset palette, bold graphic composition
	Food	4:3	$0.015	Gourmet chocolate dessert with gold leaf on a dark ceramic plate, moody side light, shallow depth of field, fine dining food photography
	Environment	16:9	$0.015	Aerial view of a fantasy cliff city carved into stone terraces above a turquoise sea, tiny bridges and hanging gardens, cinematic haze, epic scale

Recipes and measured costs are also in data/samples.json.

FAQ

What is the Grok Image API model id?

grok-imagine-1.5-apimart, with the documented alias grok-imagine-1.5-ext. The endpoint also documents grok-imagine-image and grok-imagine-image-quality.

Can I get several images in one request?

Yes — this route accepts n from 1 to 10, which makes it the cheapest way to explore variations. Most other image routes cap n at 1, so fan-out there has to happen client-side.

How does editing work?

Pass 1–5 publicly reachable image URLs in image_urls and describe the change in prompt. Only absolute http(s) URLs are accepted, so upload local files to your own storage first.

How long do result links last?

Generated links are valid for 24 hours; download and store the output as part of the job.

Related searches

• grok image api
• grok imagine api
• grok image api pricing
• grok imagine api key
• grok image editing api
• image generation api
• ai image api

Attributed links (how this repository is measured)

Purpose	Attributed link	Target
Open Grok Image on APIMart	https://go.apimart.ai/k-1a274e	docs.apimart.ai model page
Current pricing page	https://go.apimart.ai/k-4f6dcd	apimart.ai/pricing
Get an API key	https://go.apimart.ai/k-a96fe3	apimart.ai/keys

Outbound APIMart links are minted through the promo link API; hand-made tracking parameters are rejected by tools/check_links.py in CI.

Disclosure

Grok Image is a third-party model served through APIMart; this repository documents how to call it and publishes real outputs, model ids and prices, and does not claim official status. Model names, prices and documentation belong to their respective owners. Endpoint reference: https://docs.apimart.ai/en/api-reference/images/grok-imagine/generation.

Repository map

README.md             model id, pricing, parameters, quickstart, samples, FAQ
data/model.json       the pricing record for this model (CI-refreshed)
data/samples.json     prompt recipes with measured cost
tools/snapshot.py     refresh this model's prices from the public pricing payload
tools/check_links.py  attribution guard
examples/             curl, Python and JavaScript clients
assets/               real sample renders (JPEG, resized for the README)
.github/workflows/    daily price refresh + validation

License

MIT — see LICENSE.