Treci la conținut

Mage API · Model de imagine

API Z-Image

Cel mai rapid model de imagini de pe Mage

POST https://api.mage.space/v1/z_image/generate

Pe scurt

API-ul Z-Image rulează Z-Image prin Mage la POST https://api.mage.space/v1/z_image/generate. O cerere cu setările implicite costă 10 Gems (aproximativ 0,01 $), fără abonament. Z-Image nu acceptă mențiuni @handle.

  • ImagineRezultat
  • 1Variantă
  • 10Gems per imagine, implicit
  • $0.01Aproximativ, în USD

Prezentare generală

Ce face API-ul Z-Image

Foarte rapid și econom cu Gems. Text-to-image fotorealist, cu anatomie solidă și text curat, până la 2K; fără imagini de referință.

Cel mai rapid model de imagini de pe Mage: text-to-image fotorealist, cu anatomie solidă și text curat, la 1K sau 2K.

Generează doar pe baza promptului.

Pornire rapidă

Apelează API-ul Z-Image

Setează MAGE_API_KEY, trimite cererea la /z_image/generate și interoghează status_url până când cererea se finalizează.

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"])

Modele

Valori model_id pentru Z-Image

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
z-image-turboZ-ImageDa

Opțiuni

Parametri Z-Image

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

  • Imagine · de la 20 Gems

    Anima API

    Creat special pentru anime

  • Imagine · de la 35 Gems

    API Chroma

    Open-weights, construit pe Flux

  • Imagine · de la 40 de Gems

    API Flux 2

    Prompturi lungi și editări cu mai multe referințe

  • Imagine · de la 9 Gems

    API GPT Image 2

    Prompturi precise și text lizibil

  • Imagine · de la 75 Gems

    API Grok Image

    Grok Imagine, în trei niveluri de calitate

  • Imagine · de la 37 de Gems

    API Guava

    Fotorealism care trece drept fotografie

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Z-Image?
O cerere Z-Image cu setările implicite (Z-Image) costă 10 Gems, aproximativ 0,01 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Z-Image?
POST https://api.mage.space/v1/z_image/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi periodic pentru rezultat.
Ce modele Z-Image pot apela?
z-image-turbo (Z-Image). Modelul implicit este Z-Image.
Z-Image acceptă imagini de referință sau personaje?
Z-Image nu acceptă imagini, video sau audio ca intrări. Z-Image nu acceptă mențiuni @handle.
Pot folosi Z-Image din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Z-Image pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte de a genera.
Cât timp sunt păstrate rezultatele Z-Image?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.