Visión — imágenes en las solicitudes

Envía imágenes a /v1/chat/completions mediante image_url o base64. Funciona con Claude y GPT-5.6. Ejemplos en curl, Python y Node.js.

Envía una imagen junto con una solicitud de texto a /v1/chat/completions; el modelo describe su contenido, responde preguntas sobre la imagen o analiza una captura de pantalla. Se admiten tanto URLs como base64.

Modelos compatibles

Parámetro	Tipo	Descripción
`claude-opus-5.5 / claude-sonnet-5.5`	Claude	Compatibilidad completa con visión: URL y base64.
`gpt-6.1-sol`	GPT	URL y base64. Ideal para documentos y diagramas.

La imagen debe estar disponible públicamente mediante una URL o enviarse en base64. Las URL privadas (S3 firmado, redes internas) deben enviarse como base64.

Formato de la solicitud

El campo content se convierte en un array de bloques: text y image_url.

curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5.5",
    "max_tokens": 256,
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "What is in the picture? Describe it briefly."},
        {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
      ]
    }]
  }'

Base64 — sin una URL pública

Para imágenes privadas, codifica el archivo en base64 y pásalo como una URL de datos:

# base64 — for private images without a public URL
curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "max_tokens": 256,
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "What is in the picture?"},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,/9j/4AAQ..."}}
      ]
    }]
  }'

image_url parameters

Parámetro	Tipo	Descripción
`url`req.	string	URL de imagen pública o data:image/jpeg;base64,… para base64.
`detail`	"auto" \| "low" \| "high"	Detalle del análisis (solo GPT). "auto" de forma predeterminada. "high": más tokens, mejor calidad.

← AnteriorModelos Siguiente →Generación de imágenes