Referenciav1.0.0 Estable

API de AI Video to Prompt

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://aivideotoprompt.com

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://aivideotoprompt.com/api/generate

Crea una nueva tarea de generación de imágenes. Este punto de acceso es asíncrono y devuelve un task_id y el estado inicial; llama a /api/status para obtener las imágenes finales.

Este punto de acceso devuelve task_id de inmediato. Consulta /api/status periódicamente hasta que el estado sea SUCCESS para obtener las URL de las imágenes.

Parámetros del cuerpo

Nombre del parámetro	Tipo	Obligatorio	Descripción
`prompt`	string	Sí	Prompt de texto para la generación (máximo 1000 caracteres).
`aspect_ratio`	string	Sí	Relación de aspecto de la imagen generada. Valores permitidos: 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://aivideotoprompt.com/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 Sin autorizaciónClave de API no válida
402 Se requiere pagoSaldo insuficiente
429 Demasiadas solicitudesDemasiadas solicitudes

Acerca de AI Video to Prompt

AI Video to Prompt convierte los clips de referencia subidos en listas de planos con tiempos y prompts editables. Adapta un plano al modelo de video elegido o sustituye su sujeto y abre el espacio de video para generar una nueva versión. La herramienta de imagen sigue el mismo recorrido, del prompt al espacio de trabajo, con una imagen fija.

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.

Espacio de generación de imágenes Imagen a prompt