Ir al contenido principal

Integraciones

Integra modelos de imagen, video y lenguaje seleccionados mediante una API coherente.

Usa llamadas compatibles con OpenAI para chat y rol, o la API de tareas para imágenes, vídeo y audio. Elige un modelo, guarda la clave en tu servidor y sigue la ruta adecuada para el resultado que buscas.

Elige tu camino

Una clave de API, cuatro formas de conectar

Empieza donde ya trabajas. Todas las vías llegan a los mismos modelos, con los mismos precios.

Primeros pasos en 5 minutos

Tu primera imagen en cuatro pasos

Crea una tarea, guarda su ID y recoge el archivo terminado. El mismo patrón sirve para todos los modelos de imagen, video y audio.

  1. 01

    Elegir modelo

    Comparar tarea, entradas, política, disponibilidad actual y precio.

  2. 02

    Copiar solicitud

    Reemplaza el ID de modelo y el input del ejemplo por los campos exactos que muestra esa página de modelo. Nunca adivines parámetros mirando otro modelo.

  3. 03

    Enviar desde el servidor

    HTTP 202 significa que la tarea se aceptó, no que la generación terminó; el código de negocio del formato de respuesta sigue siendo code: 200. Guarda data.taskId de inmediato; estimatedCost es el importe retenido para esta tarea.

  4. 04

    Consultar el estado con reintentos acotados

    queued y running siguen en ejecución; succeeded, failed y expired son estados finales. Detén las consultas en cualquier estado final en vez de esperar solo el éxito.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image es un endpoint real de texto a imagen. Para otro modelo multimedia, utiliza su ID exacto y su esquema.

Directorio

Todas las integraciones en un sitio

Elige la herramienta que ya usas. Cada tarjeta abre su guía de configuración.

Seguridad del servidor

Tres cosas que producción tiene que resolver

Estas tres reglas cubren la filtración de la clave, el cobro duplicado y la pérdida de tareas. Es el mínimo antes de salir a producción.

Mantén la clave API en el servidor

No expongas la clave en el navegador, paquete móvil, prompt, registro o salida del agente. Envía solicitudes desde un backend bajo tu control.

Idempotency-Key

Envía un Idempotency-Key estable en cada creación de tarea. Si el resultado de red es incierto, reintenta el mismo trabajo con la misma clave para no generar dos tareas facturables.

Sigue las tareas multimedia aceptadas

Guarda el taskId y usa un webhook firmado o comprobaciones limitadas. Una tarea aceptada empieza y no se puede cancelar. Las tareas fallidas o vencidas normalmente no se cobran. Algunos modelos cobran los rechazos de contenido según lo indicado en su página; consulta esas condiciones antes de enviar.

Documentación API

Abrir la referencia que responde tu duda