Vetsa Logo Light
Vetsa Cloud v1.3.0 (Vision Enabled)

Documentación Oficial
Vetsa Intelligence API

La guía completa para integrar visión, lenguaje, video, audio y búsqueda web en tus aplicaciones.

Ruta de chat (todos los modelos)

POST https://api.vetsa.es/v1/generate

Autenticación

Header: x-api-key: TU_API_KEY
¿No tienes una API Key? Crea una gratis en el Dashboard

🧠 Modelos Disponibles

Modelo (ID) Categoría Descripción
vetsa-auto Router Detecta automáticamente si necesitas texto, imagen, video o búsqueda. Recomendado para uso general.
spaik-pro Texto Web Audio El cerebro principal de Vetsa Intelligence. Razonamiento complejo, búsqueda online, TTS y transcripción.
spaik-vision-v2 Creación Generación de imágenes fotorrealistas desde cero (Text-to-Image) impulsado por Vetsa Vision.
spaik-vision-flash Edición Modificación de imágenes existentes (Remix/Inpainting) impulsado por Spaik Flash. Requiere imagen base.
spaik-sight Análisis Capacidad de "ver". Describe imágenes y responde preguntas visuales con Vetsa Sight.
spaik-pro-vision Video Generación Análisis de video (YouTube/TikTok) y generación de clips de hasta 5 segundos (Text-to-Video e Image-to-Video).
Generación de Texto

Genera respuestas coherentes, escribe código o mantén conversaciones fluidas.

  • • Modelo: spaik-pro (inteligente) o spaik-v1 (rápido).
  • • Uso: Asistentes virtuales, redacción, traducción.
curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-pro",
    "contents": "Escribe un poema sobre la inteligencia artificial."
  }'
Creación de Imágenes

Crea imágenes desde cero utilizando el motor Spaik Vision V2.

Parámetros (options):

  • width: number (opcional)
  • height: number (opcional)
  • aspect_ratio: "1:1" | "16:9" | "9:16" (auto-calculado si se omite)
curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-vision-v2",
    "contents": "Un astronauta cyberpunk en neón, 8k, detallado",
    "options": {
      "aspect_ratio": "16:9"
    }
  }'
Análisis de Imágenes

Usa Spaik Sight para "ver" una imagen y describirla o responder preguntas sobre ella.

💡 Envía la imagen en Base64 dentro de options.image.

curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-sight",
    "contents": "¿Qué ingredientes hay en esta comida?",
    "options": {
      "image": "data:image/jpeg;base64,/9j/4AAQSc..."
    }
  }'
Edición de Imágenes (Remix)

Transforma una imagen existente ("Image-to-Image") usando Spaik Vision Flash. Ideal para cambiar estilos o detalles.

💡 Requiere options.imageUrl (URL pública) o options.image (Base64) como fuente.

curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-vision-flash",
    "contents": "Haz que parezca un dibujo a lápiz",
    "options": {
      "imageUrl": "https://mi-servidor.com/foto.jpg"
    }
  }'
Generación de Audio (IA + Voz)

Spaik Pro piensa una respuesta y la dice en voz alta.

Voces Disponibles:

• emily (Fem) • jonas (Masc) • alexa (Fem) • luis-angel (Masc) 
curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-pro",
    "contents": "Hola, responde como si fueras un pirata.",
    "options": {
      "output": "audio",
      "voice": "jonas"
    }
  }'
Búsqueda Online (Spaik Online)

Conecta el modelo spaik-pro a internet en tiempo real (Google Search). Obtén respuestas sobre eventos actuales, clima, noticias y datos en vivo.

🚀 Simplemente añade "search": true en las opciones.

curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-pro",
    "contents": "¿Qué precio tiene el dólar hoy y qué noticias hay?",
    "options": {
      "search": true
    }
  }'
Análisis de Video

Envía una URL de YouTube o TikTok y pide resúmenes, extracción de datos o análisis de sentimiento usando Spaik Pro Vision. 

curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-pro-vision",
    "contents": "Dame los 5 puntos clave de este video",
    "options": {
      "videoUrl": "https://www.youtube.com/watch?v=..."
    }
  }'
Generación de Video

Genera clips de video de hasta 5 segundos en 720p con Spaik Pro Vision. Dos modos disponibles:

Parámetros (options):

  • mode: "generate_video" | "txt2vid" | "img2vid" (obligatorio)
  • duration: number (1–5, default: 4)
  • aspect_ratio: "16:9" | "9:16" | "1:1" (default: "16:9")
  • imageUrl: string (solo para img2vid)

🎬 La respuesta incluye videoBase64 (MP4 en Base64) y mimeType: "video/mp4".

Text-to-Video 

curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-pro-vision",
    "contents": "Un gato jugando en la nieve",
    "options": {
      "mode": "generate_video",
      "duration": 4,
      "aspect_ratio": "16:9"
    }
  }'

Image-to-Video 

curl -X POST https://api.vetsa.es/v1/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -d '{
    "model": "spaik-pro-vision",
    "contents": "Anima esta foto con movimiento suave",
    "options": {
      "mode": "img2vid",
      "imageUrl": "https://mi-servidor.com/foto.jpg",
      "duration": 5
    }
  }'

Códigos de Error

Referencia rápida de los códigos de estado HTTP y mensajes de error que puedes encontrar al usar la API.

400 Bad Request

Petición Incorrecta

El cuerpo JSON está mal formado, faltan parámetros obligatorios (como `model` o `contents`), o el modelo solicitado no existe.

401 Unauthorized

No Autorizado

Falta la API Key en el header x-api-key o la clave proporcionada es inválida/inexistente.

402 Payment Required

Cuota Excedida

Has alcanzado el límite de uso de tu plan actual. Contacta a soporte para aumentar tu cuota o espera al reinicio mensual.

403 Forbidden

Prohibido

Tu API Key está desactivada o suspendida por administración. También puede ocurrir si intentas acceder desde un dominio no autorizado.

429 Too Many Requests

Límite de Velocidad

Estás enviando peticiones demasiado rápido (Rate Limit). Implementa un "backoff" exponencial en tu código.

500 Server Error

Error Interno

Un problema inesperado en los servidores de Vetsa Cloud. Si persiste, contacta a soporte con tu ID de petición.

Solución de Problemas: Integración de Audio

Un error común al integrar el modelo spaik-pro en modo audio es intentar leer la propiedad incorrecta en la respuesta JSON. Asegúrate de leer audioContent.

Incorrecto

Intentar leer audioBase64 (propiedad deprecada).

// ❌ Esto lanzará "undefined"
const audio = response.data.audioBase64;
if (!audio) throw new Error("No audio received");
Correcto

La API retorna el audio en audioContent.

// ✅ Propiedad correcta: audioContent
const audio = response.data.audioContent;
const audioSource = `data:audio/mp3;base64,${audio}`;