Ottieni una chiave API

Per utilizzare l'API Gemini, è necessaria una chiave API. Puoi creare una chiave con un clic in Google AI Studio.

Ottenere una chiave API

Verifica la chiave API con un comando curl

Puoi utilizzare un comando curl per verificare la configurazione. Puoi passare la chiave API nell'URL:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Oppure nell'intestazione x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

Proteggere la tua chiave API

È importante tenere al sicuro la chiave dell'API Gemini. Ecco alcuni aspetti da tenere presenti quando utilizzi la chiave API Gemini:

  • L'API Gemini di Google AI utilizza le chiavi API per l'autorizzazione. Se altre persone hanno accesso alla tua chiave API Gemini, possono effettuare chiamate utilizzando la quota del tuo progetto, che potrebbero comportare la perdita di quota o ulteriori addebiti (se la fatturazione è attivata). Le chiavi API proteggono anche l'accesso a modelli e file ottimizzati.

  • Quando fai clic su Ottieni chiave API in Google AI Studio, scegli se eseguire il provisioning di una chiave API Gemini in un progetto Google Cloud nuovo o esistente. La Elenco delle chiavi API in Google AI Studio mostra tutte le chiavi API di cui AI Studio ha eseguito il provisioning per l'utilizzo con API Gemini di IA (insieme a tutti i progetti Google Cloud associati).

    • Tuttavia, qualsiasi chiave API all'interno del progetto Google Cloud può potenzialmente essere utilizzata per chiamare l'API Gemini di Google AI. Puoi visualizzare e gestire tutti i tuoi le chiavi API del progetto API e Servizi > Riquadro delle credenziali nella console Google Cloud.

  • Aggiunta in corso... Restrizioni relative alle chiavi API può contribuire a limitare l'area della superficie utilizzabile tramite ciascuna chiave API. Per impostazione predefinita, La chiave API Gemini generata da Google AI Studio può essere utilizzata solo con l'IA di Google l'API Gemini (ufficialmente denominata "API Generative Language" generativelanguage.googleapis.com).

    • Se all'interno del progetto Google Cloud sono presenti chiavi API prive di API restrizioni o chiavi API che hanno inserito nella lista consentita il linguaggio generativo API, queste chiavi possono essere utilizzate con l'API Gemini di Google AI. È meglio di limitare ogni chiave API solo alle API che chiami utilizzando quelle chiave.
    • Anche con le restrizioni relative alle chiavi API, se un utente malintenzionato ottiene il tuo chiave API, possono usarla per effettuare chiamate utilizzando la quota del progetto per le API incluse nella lista consentita per quella chiave API.

  • Sei responsabile di mantenere sicura la tua chiave dell'API Gemini.

    • NON verificare le chiavi dell'API Gemini nel controllo del codice sorgente.
    • Rischio delle applicazioni lato client (Android, Swift, web e Dart/Flutter) esporre le chiavi API, pertanto sconsigliamo di utilizzare gli SDK del client Google AI nelle app di produzione per chiamare l'API Gemini di Google AI direttamente dal tuo web e mobile. Consulta le guide rapide sugli SDK per saperne di più. best practice specifiche per ogni linguaggio per proteggere la tua chiave API.

Per alcune best practice generali, puoi anche consultare articolo di assistenza.

Passaggi successivi