> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vision

> Analizza immagini con i modelli di chat Venice abilitati alla visione usando contenuti multimodali nei messaggi dell'API chat completions compatibile con OpenAI.

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

<CodeGroup>
  ```python Python theme={"system"}
  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)
  ```

  ```javascript Node.js theme={"system"}
  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);
  ```

  ```bash cURL theme={"system"}
  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"
              }
            }
          ]
        }
      ]
    }'
  ```
</CodeGroup>

## Uso di Immagini Base64

Puoi anche passare una data URL in base64 quando l'immagine è locale o privata:

```json theme={"system"}
{
  "type": "image_url",
  "image_url": {
    "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  }
}
```

## Scelta di un Modello di Visione

Usa la pagina [Modelli di Testo](/models/text) o l'[API Modelli](/api-reference/endpoint/models/list) per trovare modelli che supportano la visione. Il supporto alla visione è indicato tra le capacità del modello.

<Tip>
  Per input di tipo documento, usa gli [Input da File](/guides/features/file-inputs) quando desideri che Venice estragga il testo da un file. Usa la visione quando conta il layout visivo o il contenuto stesso dell'immagine.
</Tip>

## 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

* [API Chat Completions](/api-reference/endpoint/chat/completions)
* [Modelli di Testo](/models/text)
* [Guida agli Input da File](/guides/features/file-inputs)
* [Guida alle Risposte Strutturate](/guides/features/structured-responses)