Ir al contenido principal

Glosario para desarrolladores

Entiende la API antes de integrarla.

Definiciones prácticas para elegir modelo, gestionar estados, verificar callbacks, estimar el uso y proteger los archivos de los usuarios.

01

API de generación asíncrona

Definición

Una API que acepta una solicitud de medios, devuelve un taskId duradero y termina fuera de la petición HTTP original.

Nota de implementación

Guarda el taskId antes del polling o Webhook. queued y running están en curso; succeeded, failed y expired son terminales. Una tarea aceptada no se puede cancelar.

Página relacionada →
02

Clave de idempotencia

Definición

Un identificador del cliente que une los reintentos a una tarea lógica y evita trabajo facturable duplicado.

Nota de implementación

Reutiliza la misma clave solo para la misma solicitud validada, guárdala con la tarea y devuelve el resultado original al reintentar.

Página relacionada →
03

Firma Webhook

Definición

Un valor criptográfico para verificar que el callback procede de la API y no fue alterado.

Nota de implementación

Verifica el cuerpo sin modificar, rechaza marcas de tiempo antiguas y deduplica eventId antes de cambiar tarea o cobro.

Página relacionada →
04

Esquema del modelo

Definición

La especificación legible por máquina que describe campos, tipos, límites, valores predeterminados y salida.

Nota de implementación

Genera formularios y validación del servidor desde el esquema publicado y registra la versión usada en cada tarea.

Página relacionada →
05

Imagen de referencia

Definición

Una entrada que guía identidad, composición, estilo o movimiento en una generación de imagen o vídeo.

Nota de implementación

Registra procedencia y consentimiento y valida el formato; una referencia no autoriza a reproducir a una persona real.

Página relacionada →
06

Precios por uso

Definición

El coste se calcula según el uso real. Cada modelo indica la unidad aplicable, como imagen, segundo de salida, megapíxel, token o solicitud.

Nota de implementación

Muestra la unidad y la estimación antes de ejecutar; los mínimos, la duración y la cantidad de salidas pueden cambiar el total.

Página relacionada →
07

Modelo de IA con menos filtros de contenido

Definición

Una opción de modelos concretos con menos filtros. La etiqueta es información de producto, no aprobación de la plataforma.

Nota de implementación

Antes de enviar, implementa en tu aplicación los controles de edad, consentimiento, personas reales y jurisdicción que requieran tus usuarios.

Página relacionada →

¿Listo para integrar un modelo?

Revisa entradas, ejemplos y precios actuales y consulta la estimación de tus ajustes antes de ejecutar.