Vai al contenuto principale
I modelli di visione possono analizzare immagini insieme a prompt testuali. Usali per la comprensione delle immagini, l’estrazione, la classificazione, il visual question answering e il ragionamento multimodale. Venice supporta messaggi di chat multimodali compatibili con OpenAI. Inserisci blocchi di testo e immagini nello stesso messaggio utente, quindi invia la richiesta a un modello abilitato alla visione.

​
Utilizzo di Base

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["VENICE_API_KEY"],
    base_url="https://api.venice.ai/api/v1",
)

response = client.chat.completions.create(
    model="qwen3-vl-235b-a22b",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Describe this image in three bullets."},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://www.gstatic.com/webp/gallery/1.jpg"
                    },
                },
            ],
        }
    ],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VENICE_API_KEY,
  baseURL: "https://api.venice.ai/api/v1",
});

const response = await client.chat.completions.create({
  model: "qwen3-vl-235b-a22b",
  messages: [
    {
      role: "user",
      content: [
        { type: "text", text: "Describe this image in three bullets." },
        {
          type: "image_url",
          image_url: {
            url: "https://www.gstatic.com/webp/gallery/1.jpg",
          },
        },
      ],
    },
  ],
});

console.log(response.choices[0].message.content);

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-235b-a22b",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Describe this image in three bullets."},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://www.gstatic.com/webp/gallery/1.jpg"
            }
          }
        ]
      }
    ]
  }'

​
Uso di Immagini Base64

Puoi anche passare una data URL in base64 quando l’immagine è locale o privata: 
{
  "type": "image_url",
  "image_url": {
    "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  }
}

​
Scelta di un Modello di Visione

Usa la pagina Modelli di Testo o l’API Modelli per trovare modelli che supportano la visione. Il supporto alla visione è indicato tra le capacità del modello.
Per input di tipo documento, usa gli Input da File quando desideri che Venice estragga il testo da un file. Usa la visione quando conta il layout visivo o il contenuto stesso dell’immagine.

​
Consigli sul Prompting

  • Indica al modello su cosa concentrarsi: oggetti, testo, layout, sicurezza, difetti o differenze.
  • Richiedi output strutturato quando la tua applicazione ha bisogno di campi che puoi analizzare.
  • Assicurati che gli URL delle immagini siano accessibili all’API, oppure usa data URL in base64 per immagini private.
  • Usa un modello con contesto sufficiente se combini immagini con istruzioni lunghe.

​
Risorse Correlate