Mage API · Beeldmodel
Z-Image API
Het snelste afbeeldingsmodel van Mage
POST https://api.mage.space/v1/z_image/generateIn één oogopslag
De Z-Image API draait Z-Image via Mage op POST https://api.mage.space/v1/z_image/generate. Een verzoek met de standaardinstellingen kost 10 Gems (ongeveer $0,01), zonder abonnement. Z-Image ondersteunt geen @handle-vermeldingen.
- AfbeeldingUitvoer
- 1Variant
- 10Gems per afbeelding, standaard
- $0.01Ongeveer, in USD
Overzicht
Wat de Z-Image API doet
Bliksemsnel en zuinig met Gems. Fotorealistische tekst-naar-afbeelding met degelijke anatomie en strakke letters, tot 2K; geen referentie-afbeeldingen.
Het snelste afbeeldingsmodel van Mage: fotorealistische tekst-naar-afbeelding met degelijke anatomie en letters, in 1K of 2K.
Het genereert alleen op basis van de prompt.
Snel starten
De Z-Image API aanroepen
Stel MAGE_API_KEY in, verstuur naar /z_image/generate en poll status_url tot het verzoek klaar is.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_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": "4:5",
"model_id": "z-image-turbo"
}' | 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('z_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'z-image-turbo',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("z_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo",
})
print(request["result"]["url"])Modellen
Z-Image model_id-waarden
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| z-image-turbo | Z-Image | Ja |
Opties
Z-Image-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
Meer beeldmodellen
Andere API's voor beeldgeneratie op Mage
Anima API
Speciaal gemaakt voor anime
Chroma API
Open weights, gebouwd op Flux
Flux 2 API
Lange prompts en bewerkingen met meerdere referenties
GPT Image 2 API
Nauwkeurige prompts en leesbare tekst
Grok Image API
Grok Imagine, in twee varianten
Guava API
Fotorealisme dat voor een echte foto doorgaat
FAQ
Veelgestelde vragen
Wat kost de Z-Image API?
Wat is het endpoint van de Z-Image API?
Welke Z-Image-modellen kan ik aanroepen?
Ondersteunt Z-Image referentie-afbeeldingen of characters?
Kan ik Z-Image gebruiken vanuit Claude of ChatGPT?
Hoe lang worden Z-Image-resultaten bewaard?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.