Mage API · Beeldmodel

Grok Image API

Grok Imagine in drie kwaliteitsniveaus

Vraag een API-sleutel aanProbeer Grok Image in de playground
POST https://api.mage.space/v1/grok_image/generate

In één oogopslag

De Grok Image API draait Grok Image Quality en 2 andere varianten via Mage op POST https://api.mage.space/v1/grok_image/generate. Een verzoek met de standaardinstellingen kost 75 Gems (ongeveer $0,075), zonder abonnement. Grok Image gebruikt opgeslagen personages en referenties via @handle in de prompt.

Overzicht

Wat de Grok Image API doet

Het Grok Imagine-afbeeldingsmodel van xAI in drie kwaliteitsniveaus. Genereert of bewerkt op basis van maximaal 3 referentieafbeeldingen en behoudt daarbij de details van het origineel. Het veiligheidsfilter van xAI is van toepassing.

De Grok Imagine-afbeeldingsmodellen van xAI in drie kwaliteitsniveaus, voor generatie en bewerkingen op basis van referentieafbeeldingen. Het veiligheidsfilter van xAI is van toepassing.

Accepteert image, additional_images als invoer.

Snel starten

De Grok Image API aanroepen

Stel MAGE_API_KEY in, verstuur je verzoek naar /grok_image/generate en poll status_url tot het verzoek is voltooid.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "1:1",
  "model_id": "grok-imagine-image-quality"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('grok_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '1:1',
  model_id: 'grok-imagine-image-quality',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("grok_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "1:1",
    "model_id": "grok-imagine-image-quality",
})

print(request["result"]["url"])

Modellen

model_id-waarden voor Grok Image

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

model_idNaamStandaard
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualityJa
grok-imagine-image-2.0Grok Image 2.0

Opties

Parameters van Grok Image

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

VeldWaarden
aspect_ratio1: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
resolution1k, 2k

Invoer

Media-invoer die Grok Image accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
imageDe referentieafbeelding.
additional_imagesExtra referentieafbeeldingen.

Meer beeldmodellen

Andere API's voor beeldgeneratie op Mage

Afbeelding · vanaf 37 Gems

Guava API

Fotorealisme dat voor een echte foto doorgaat

Afbeelding · vanaf 20 Gems

HiDream API

Snel en veelzijdig, met negatieve prompts

Afbeelding · vanaf 20 Gems

Krea 2 API

Prachtige esthetiek in enkele seconden

Afbeelding · vanaf 135 Gems

Mango API

Onze vlaggenschip-afbeeldingsfamilie

Afbeelding · vanaf 68 Gems

Nano Banana 2 API

Scherpe, leesbare tekst, tot 4K

Afbeelding · vanaf 15 Gems

SDXL Plus API

SDXL met gerepareerde gezichten en handen

FAQ

Veelgestelde vragen

Wat kost de Grok Image API?

Een Grok Image-verzoek met de standaardinstellingen (Grok Image Quality) kost 75 Gems, ongeveer $0,075. Andere resoluties, duur en varianten veranderen de prijs; in de respons staat het exacte bedrag. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.

Wat is het endpoint van de Grok Image API?

POST https://api.mage.space/v1/grok_image/generate met een Authorization: Bearer-header met je Mage API-sleutel. De respons bevat een status_url die je kunt pollen voor het resultaat.

Welke Grok Image-modellen kan ik aanroepen?

grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). De standaard is Grok Image Quality.

Ondersteunt Grok Image referentieafbeeldingen of personages?

Grok Image accepteert image, additional_images. Grok Image gebruikt opgeslagen personages en referenties via @handle in de prompt.

Kan ik Grok Image gebruiken via Claude of ChatGPT?

Ja. Koppel de Mage MCP-server aan Claude, ChatGPT, Claude Code, Grok of Cursor en vraag op naam om Grok Image. Je assistent leest de opties uit met get_model en noemt de prijs voordat er iets wordt gegenereerd.

Hoe lang worden Grok Image-resultaten bewaard?

Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

Vraag een API-sleutel aanProbeer Grok Image in de playground

Gerelateerd