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/generatePe 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_id | Nume | Implicit |
|---|---|---|
| z-image-turbo | Z-Image | Da |
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âmp | Valori |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
Mai multe modele de imagini
Alte API-uri de generare de imagini pe Mage
Anima API
Creat special pentru anime
API Chroma
Open-weights, construit pe Flux
API Flux 2
Prompturi lungi și editări cu mai multe referințe
API GPT Image 2
Prompturi precise și text lizibil
API Grok Image
Grok Imagine, în trei niveluri de calitate
API Guava
Fotorealism care trece drept fotografie
Întrebări frecvente
Întrebări frecvente
Cât costă API-ul Z-Image?
Care este endpoint-ul API-ului Z-Image?
Ce modele Z-Image pot apela?
Z-Image acceptă imagini de referință sau personaje?
Pot folosi Z-Image din Claude sau ChatGPT?
Cât timp sunt păstrate rezultatele Z-Image?
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.