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âmetro | Tipo | Descrição |
|---|---|---|
claude-opus-5.5 / claude-sonnet-5.5 | Claude | Suporte completo a visão — URL e base64. |
gpt-6.1-sol | GPT | URL 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âmetro | Tipo | Descrição |
|---|---|---|
urlreq. | string | URL 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. |