Documentación

Introducción

Lleva la generación de imagen y vídeo a tu propio producto.

La API expone exactamente lo que usa el estudio: los mismos modelos, el mismo cálculo de coste, la misma cadena de renderizado. Lo que puedes generar en el navegador lo generas con una clave, y los resultados van a parar igualmente a tu biblioteca de recursos.

Qué puedes hacer

Texto / imagen a imagenImágenes de referencia, proporciones y calidades 1K/2K/4K. Hasta 4 imágenes por petición.
Texto / imagen a vídeoPrimer y último fotograma, imágenes de referencia y varias resoluciones. La duración se ajusta a la especificación elegida.
Elige el modeloTodos los modelos publicados son invocables. Consulta /v1/models para ver ids y precios disponibles.
Consulta tu saldoLee los créditos disponibles cuando quieras y evita que un lote se corte a medias.

Diseño de la API

La forma sigue a OpenAI: las claves empiezan por sk-, viajan en Authorization: Bearer, las rutas cuelgan de /v1 y los fallos devuelven un objeto error de estructura fija. Si has usado el SDK de OpenAI, cambiar la URL base te lleva casi todo el camino.

La generación de imágenes admite las dos formas. Por defecto es síncrona: la llamada espera a que la imagen esté lista y responde con la misma estructura que el endpoint images/generations de OpenAI, así que el SDK de OpenAI y las pasarelas de reenvío pueden usar la plataforma como proveedor compatible sin más. Con async: true pasas al flujo asíncrono: recibes un id de tarea al instante y lees el resultado en GET /v1/tasks/{id}.

El vídeo solo es asíncrono: renderizar lleva minutos, y esperar de forma síncrona dejaría la conexión pegada al tiempo límite de la pasarela, con un reintento que cobraría dos veces. Para lotes, mucha concurrencia o latencia sensible, usa también el flujo asíncrono con imágenes.

URL base de todos los endpoints: https://open.pikpikgo.com/v1

Siguientes pasos