Mage API · Beeldmodel
Grok Image API
Grok Imagine, in twee varianten
POST https://api.mage.space/v1/grok_image/generateIn één oogopslag
De Grok Image API draait Grok Image 2.0 en 1 andere variant via Mage op POST https://api.mage.space/v1/grok_image/generate. Een verzoek met de standaardinstellingen kost 90 Gems (ongeveer $0,09), zonder abonnement. Grok Image werkt met opgeslagen personages en referenties via @handle in de prompt.
- AfbeeldingUitvoer
- 2Varianten
- 90Gems per afbeelding, standaard
- $0.09Ongeveer, in USD
Overzicht
Wat de Grok Image API doet
Het Grok Imagine-afbeeldingsmodel van xAI in twee varianten. 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 twee varianten, voor genereren en bewerken op basis van referentieafbeeldingen: Grok Image 2.0 (`grok-imagine-image-2.0`), de standaardvariant, en Grok Image (`grok-imagine-image`) voor goedkope schetsen. xAI heeft Grok Image Quality (`grok-imagine-image-quality`) op 2 november 2026 buiten gebruik gesteld, en een verzoek dat dit model noemt, wordt geweigerd. 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-2.0"
}' | 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-2.0',
});
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-2.0",
})
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_id | Naam | Standaard |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Ja |
Opties
Parameters van Grok Image
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| aspect_ratio | 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 | 1k, 2k |
Invoer
Media-invoer die Grok Image accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| image | De referentieafbeelding. |
| additional_images | Extra referentieafbeeldingen. |
Meer beeldmodellen
Andere API's voor beeldgeneratie op Mage
Guava API
Fotorealisme dat voor een echte foto doorgaat
HiDream API
Snel en veelzijdig, met negatieve prompts
Krea 2 API
Prachtige esthetiek in enkele seconden
Mango API
Onze vlaggenschip-afbeeldingsfamilie
MiniMax H3 Image API
Native afbeeldingen van 16 megapixel, open weights
MOSS-Image API
Lange prompts en tweetalige tekst, open weights
FAQ
Veelgestelde vragen
Wat kost de Grok Image API?
Wat is het endpoint van de Grok Image API?
Welke Grok Image-modellen kan ik aanroepen?
Ondersteunt Grok Image referentieafbeeldingen of personages?
Kan ik Grok Image gebruiken via Claude of ChatGPT?
Hoe lang worden Grok Image-resultaten bewaard?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.