API Files

Gemini può gestire contemporaneamente vari tipi di dati di input, tra cui testo, immagini e audio.

Questa guida mostra come utilizzare i file multimediali utilizzando l'API Files. Le operazioni di base sono le stesse per file audio, immagini, video, documenti e altri tipi di file supportati.

Per indicazioni sui prompt dei file, consulta la sezione Guida ai prompt dei file.

Carica un file

Puoi utilizzare l'API Files per caricare un file multimediale. Utilizza sempre l'API Files quando le dimensioni totali della richiesta (inclusi i file, il prompt testuale, le istruzioni di sistema, ecc.) sono superiori a 100 MB. Per i file PDF, il limite è 50 MB.

Il seguente codice carica un file e lo utilizza in una chiamata a interactions.create.

Python

from google import genai

client = genai.Client()

myfile = client.files.upload(file="path/to/sample.mp3")

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input=[
        {"type": "text", "text": "Describe this audio clip"},
        {"type": "audio", "uri": myfile.uri, "mime_type": myfile.mime_type}
    ]
)

print(interaction.output_text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

async function main() {
  const myfile = await client.files.upload({
    file: "path/to/sample.mp3",
    config: { mime_type: "audio/mpeg" },
  });

  const interaction = await client.interactions.create({
    model: "gemini-3.6-flash",
    input: [
      { type: "text", text: "Describe this audio clip" },
      { type: "audio", uri: myfile.uri, mime_type: myfile.mimeType }
    ]
  });
  console.log(interaction.output_text);
}

await main();

Go

file, err := client.Files.UploadFromPath(ctx, "path/to/sample.mp3", nil)
if err !=