Referenciav1.0.0 Estable

Z Image Turbo API

Integra capacidades de generación de imágenes con IA de alto rendimiento. Esta documentación proporciona una referencia completa de la API, guías de integración y ejemplos de código para ayudar a los desarrolladores a crear rápidamente aplicaciones de generación de imágenes con IA.

https://zimageturbo.ai

Inicio rápido

Completa tu primera llamada a la API en solo dos pasos: envía una tarea de generación y luego consulta su estado.

Enviar tarea

Envía una solicitud POST al endpoint de generación para obtener un ID de tarea.

Consultar estado

Usa el ID de tarea para comprobar el progreso hasta obtener la URL de la imagen.

Autenticación

Nota: mantén tu clave de API segura y no la expongas en código del lado del cliente.

Encabezado HTTP

Authorization: Bearer {YOUR_API_KEY}

POST

https://zimageturbo.ai/api/generate

Create a new image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the final images.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Parámetros del cuerpo

Nombre del parámetro	Tipo	Obligatorio	Descripción
`prompt`	string	Sí	Text prompt for generation (max 1000 characters).
`aspect_ratio`	string	Sí	Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.

Respuesta (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://zimageturbo.ai/api/status

Consulta el estado de ejecución y los resultados de una tarea.

Parámetros de consulta

Nombre del parámetro	Obligatorio	Descripción
`task_id`	Sí	El ID devuelto al enviar la tarea.

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Facturación

Costo por generación

$0.02 / solicitud

Las tareas fallidas no se cobran.

Manejo de errores

401 UnauthorizedClave de API no válida
402 Payment RequiredSaldo insuficiente
429 Too Many RequestsDemasiadas solicitudes

Acerca de Z Image Turbo

Z Image Turbo es un motor de generación optimizado sobre los modelos de difusión más recientes. Se centra en aumentar la velocidad de inferencia hasta el 300% de los modelos tradicionales manteniendo una fidelidad extremadamente alta. Es adecuado para interacción en tiempo real, generación de recursos para videojuegos y escenarios de diseño para comercio electrónico.

Z-Image-Turbo — modelo texto-a-imagen de 6B parámetros, ultrarrápido

Z-Image-Turbo es un modelo texto-a-imagen de 6 mil millones de parámetros de Tongyi-MAI, diseñado para entornos de producción donde la latencia y el rendimiento son críticos. Utiliza solo 8 pasos de muestreo para renderizar una imagen completa, logrando latencias inferiores a un segundo en GPUs de centros de datos y ejecutándose cómodamente en muchas tarjetas de 16 GB de VRAM de consumo.

Generación ultrarrápida con calidad lista para producción

Mientras muchos modelos de difusión necesitan decenas de pasos, Z-Image-Turbo está optimizado agresivamente en torno a un muestreador de 8 pasos. Esto mantiene la inferencia extremadamente rápida y, al mismo tiempo, ofrece imágenes fotorrealistas y texto confiable en la imagen, lo que lo convierte en una excelente opción para productos interactivos, paneles de control y backends a gran escala, no solo trabajos por lotes offline.

¿Por qué se ve tan bien?

Salida fotorrealista a gran velocidad — Genera imágenes de alta fidelidad y realistas que funcionan para fotos de producto, banners principales y elementos visuales de interfaz sin esperas de varios segundos.
Prompts y texto bilingües — Entiende prompts en inglés y chino y puede renderizar texto multilingüe directamente en la imagen, útil para campañas globales, pósteres y capturas de pantalla.
Baja latencia con pocas etapas — Solo 8 evaluaciones de función por imagen proporcionan una latencia extremadamente baja, ideal para chatbots, herramientas de configuración, asistentes de diseño y cualquier experiencia “clic → imagen”.
Uso eficiente de VRAM — Funciona bien en entornos con 16 GB de VRAM, reduciendo los costos de hardware y haciendo más viables las implementaciones locales o en el edge.
Escala para generación masiva — Su eficiencia hace viables grandes trabajos — catálogos, flujos continuos de imágenes o miniaturas generadas automáticamente — sin disparar el presupuesto de cómputo.
Generaciones reproducibles — Un parámetro de semilla configurable permite recrear una imagen anterior o generar variaciones controladas para proteger la marca y experimentar.

Cómo usar

promptprompt – descripción en lenguaje natural de la escena, el estilo y cualquier texto sobre la imagen (en inglés o chino).
sizesize (ancho / alto) – elige la resolución de salida; admite imágenes cuadradas y rectangulares de alta resolución (por ejemplo, 1536 × 1536).
seedseed – establece -1 para resultados aleatorios o usa un entero fijo para hacer las salidas reproducibles.

Z-Image-Edit Prompts