v1.0.0Estable

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.

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

Encabezado HTTP

Authorization: Bearer {YOUR_API_KEY}

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

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.

{
  "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.

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "xxx",
      "size": "1024*1024",
      "seed": "-1"
    },
    "response": [
      "https://xxx.com/sample.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 — 6B-parameter, ultra-fast text-to-image

Z-Image-Turbo is a 6B-parameter text-to-image model from Tongyi-MAI, engineered for production workloads where latency and throughput really matter. It uses only 8 sampling steps to render a full image, achieving sub-second latency on data-center GPUs and running comfortably on many 16 GB VRAM consumer cards.

Ultra-fast generation with production-ready quality

Where many diffusion models need dozens of steps, Z-Image-Turbo is aggressively optimised around an 8-step sampler. That keeps inference extremely fast while still delivering photorealistic images and reliable on-image text, making it a strong fit for interactive products, dashboards, and large-scale backends—not just offline batch jobs.

Why it looks so good?

• Photorealistic output at speed — Generates high-fidelity, realistic images that work for product photos, hero banners, and UI visuals without multi-second waits.
• Bilingual prompts and text — Understands prompts in English and Chinese, and can render multilingual text directly in the image—helpful for cross-market campaigns, posters, and screenshots.
• Low-latency, low-step design — Only 8 function evaluations per image deliver extremely low latency, ideal for chatbots, configuration tools, design assistants, and any “click → image” experience.
• Friendly VRAM footprint — Runs well in 16 GB VRAM environments, reducing hardware costs and making local or edge deployments more realistic.
• Scales for bulk generation — Its efficiency makes large jobs—catalogues, continuous feed images, or auto-generated thumbnails—practical without blowing up compute budgets.
• Reproducible generations — A controllable seed parameter lets you recreate a previous image or generate small, controlled variations for brand safety and experimentation.

How to use

prompt – natural-language description of the scene, style, and any on-image text (English or Chinese).
size (width / height) – choose the output resolution; supports square and rectangular images up to high resolutions (for example, 1536 × 1536).
seed – set to -1 for random results, or use a fixed integer to make outputs reproducible.