Mage API · Beeldmodel

Z-Image API

Het snelste afbeeldingsmodel van Mage

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

In éé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.

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_idNaamStandaard
z-image-turboZ-ImageJa

Opties

Z-Image-parameters

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

VeldWaarden
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Meer beeldmodellen

Andere API's voor beeldgeneratie op Mage

Afbeelding · vanaf 20 Gems

Anima API

Speciaal gemaakt voor anime

Afbeelding · vanaf 35 Gems

Chroma API

Open weights, gebouwd op Flux

Afbeelding · vanaf 40 Gems

Flux 2 API

Lange prompts en bewerkingen met meerdere referenties

Afbeelding · vanaf 9 Gems

GPT Image 2 API

Nauwkeurige prompts en leesbare tekst

Afbeelding · vanaf 75 Gems

Grok Image API

Grok Imagine, in drie kwaliteitsniveaus

Afbeelding · vanaf 37 Gems

Guava API

Fotorealisme dat voor een echte foto doorgaat

FAQ

Veelgestelde vragen

Wat kost de Z-Image API?

Een Z-Image-verzoek met de standaardinstellingen (Z-Image) kost 10 Gems, ongeveer $0,01. Andere resoluties, duur en varianten veranderen de prijs; het antwoord toont de exacte kosten. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.

Wat is het endpoint van de Z-Image API?

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

Welke Z-Image-modellen kan ik aanroepen?

z-image-turbo (Z-Image). De standaard is Z-Image.

Ondersteunt Z-Image referentie-afbeeldingen of characters?

Z-Image accepteert geen afbeeldingen, video's of audio als invoer. Z-Image ondersteunt geen @handle-vermeldingen.

Kan ik Z-Image gebruiken vanuit Claude of ChatGPT?

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

Hoe lang worden Z-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 Z-Image in de playground

Gerelateerd