API de Mage · Modelo de imagen
API de Z-Image
El modelo de imágenes más rápido de Mage
POST https://api.mage.space/v1/z_image/generateDe un vistazo
La API de Z-Image ejecuta Z-Image a través de Mage en POST https://api.mage.space/v1/z_image/generate. Una solicitud con los ajustes predeterminados cuesta 10 Gems (unos 0,01 $), sin suscripción. Z-Image no admite menciones con @handle.
- ImagenResultado
- 1Variante
- 10Gems por imagen, por defecto
- $0.01Aprox., en USD
Resumen
Qué hace la API de Z-Image
Rapidísimo y con un bajo consumo de Gems. Texto a imagen fotorrealista con buena anatomía y tipografía nítida, hasta 2K; sin imágenes de referencia.
El modelo de imágenes más rápido de Mage: texto a imagen fotorrealista con buena anatomía y tipografía, en 1K o 2K.
Genera solo a partir del prompt.
Inicio rápido
Llama a la API de Z-Image
Define MAGE_API_KEY, envía la solicitud a /z_image/generate y consulta status_url hasta que se complete.
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"])Modelos
Valores de model_id de Z-Image
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| z-image-turbo | Z-Image | Sí |
Opciones
Parámetros de Z-Image
Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.
| Campo | Valores |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
Más modelos de imagen
Otras API de generación de imágenes en Mage
API de Anima
Hecho a medida para anime
API de Chroma
Pesos abiertos, basado en Flux
API de Flux 2
Prompts largos y ediciones con varias referencias
API de GPT Image 2
Prompts precisos y texto legible
API de Grok Image
Grok Imagine, en dos niveles
API de Guava
Fotorrealismo que parece una fotografía
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Z-Image?
¿Cuál es el endpoint de la API de Z-Image?
¿Qué modelos de Z-Image puedo usar?
¿Z-Image admite imágenes de referencia o personajes?
¿Puedo usar Z-Image desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Z-Image?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.