Tema
Idioma

Visão — imagens nas solicitações

Envie imagens para /v1/chat/completions via image_url ou base64. Funciona com Claude e GPT-5.6. Exemplos em curl, Python e Node.js.

Envie uma imagem junto com uma solicitação de texto para /v1/chat/completions — o modelo descreve o conteúdo, responde a perguntas sobre a imagem ou analisa uma captura de tela. URLs e base64 são compatíveis.

Modelos compatíveis

ParâmetroTipoDescrição
claude-opus-5.5 / claude-sonnet-5.5ClaudeSuporte completo a visão — URL e base64.
gpt-6.1-solGPTURL e base64. Ideal para documentos e diagramas.
A imagem deve estar acessível publicamente por URL ou ser enviada em base64. URLs privadas (S3 assinado, redes internas) devem ser enviadas como base64.

Formato da solicitação

O campo content se torna um array de blocos: text e 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 — sem uma URL pública

Para imagens privadas, codifique o arquivo em base64 e passe-o como uma URL de dados:

# 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âmetroTipoDescrição
urlreq.stringURL pública de imagem ou data:image/jpeg;base64,… para base64.
detail"auto" | "low" | "high"Detalhamento da análise (somente GPT). "auto" por padrão. "high" — mais tokens, melhor qualidade.
Visão da GetVibe API — image_url em chat completions, Python e curl | GetVibe API