Guia de início rápido da API Gemini

Este guia de início rápido mostra como começar a usar a API Gemini com o SDK de sua preferência.

Python Node.js Go Dart (Flutter) Android Swift Web REST

Pré-requisitos

Neste guia de início rápido, partimos do princípio de que você já sabe usar o Android Studio para desenvolver apps Android.

Para concluir este guia de início rápido, verifique se o ambiente de desenvolvimento e o app Android atendem aos seguintes requisitos:

• Android Studio (versão mais recente)
• O app Android precisa ser destinado ao nível 21 da API ou mais recente.

Considere acessar o Gemini no dispositivo

O SDK cliente para Android descrito neste tutorial permite acessar os modelos do Gemini que são executados nos servidores do Google. Para casos de uso que envolvem processamento de dados sensíveis, disponibilidade off-line ou economia de custos para fluxos de usuários usados com frequência, considere acessar o Gemini Nano, que é executado no dispositivo. Para mais detalhes, consulte a página Android (no dispositivo).

Instalar o SDK da API Gemini

1. No arquivo de configuração do Gradle do módulo (nível do app) (como <project>/<app-module>/build.gradle.kts), adicione a dependência do SDK de IA do Google para Android:

   Kotlin

   dependencies {
   
     // add the dependency for the Google AI client SDK for Android
     implementation("com.google.ai.client.generativeai:generativeai:0.7.0")
   }
   

   Java

   Para Java, é preciso adicionar mais duas bibliotecas.

   dependencies {
   
       // add the dependency for the Google AI client SDK for Android
       implementation("com.google.ai.client.generativeai:generativeai:0.7.0")
   
       // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
       implementation("com.google.guava:guava:31.0.1-android")
   
       // Required for streaming operations (to use `Publisher` from Reactive Streams)
       implementation("org.reactivestreams:reactive-streams:1.0.4")
   }
   

2. Sincronize o projeto do Android com os arquivos do Gradle.

Configurar a autenticação

A maneira mais fácil de fazer a autenticação na API Gemini é configurar uma chave de API, conforme descrito nesta seção. Se precisar de controles de acesso mais rigorosos, use o OAuth.

Se você ainda não tem uma chave de API, crie uma no Google AI Studio.

Gerar uma chave de API no Google AI Studio

Em seguida, configure sua chave.

É altamente recomendável não verificar uma chave de API no sistema de controle de versões. Em vez disso, faça o armazenamento em um arquivo local.properties, que fica no diretório raiz do projeto, mas é excluído do controle de versões, e use o plug-in Secrets Gradle para Android para ler a chave de API como uma variável de configuração de build.

// Access your API key as a Build Configuration variable
val apiKey = BuildConfig.apiKey

// Access your API key as a Build Configuration variable
String apiKey = BuildConfig.apiKey;

Se você quiser conferir a implementação do plug-in Secrets Gradle, consulte o app de exemplo deste SDK ou use a prévia mais recente do Android Studio Iguana, que tem um modelo de inicialização da API Gemini (que inclui o arquivo local.properties para você começar).

Importar a biblioteca

Importe a biblioteca de IA generativa do Google.

// other imports...
import com.google.ai.client.generativeai.GenerativeModel

// other imports...
import com.google.ai.client.generativeai.GenerativeModel;
import com.google.ai.client.generativeai.java.GenerativeModelFutures;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.type.GenerateContentResponse;

Faça sua primeira solicitação

Use o método generateContent para gerar texto.

    val generativeModel =
    GenerativeModel(
        // Specify a Gemini model appropriate for your use case
        modelName = "gemini-1.5-flash",
        // Access your API key as a Build Configuration variable (see "Set up your API key" above)
        apiKey = BuildConfig.apiKey)

val prompt = "Write a story about a magic backpack."
val response = generativeModel.generateContent(prompt)
print(response.text)
text_generation.kt

    // Specify a Gemini model appropriate for your use case
GenerativeModel gm =
    new GenerativeModel(
        /* modelName */ "gemini-1.5-flash",
        // Access your API key as a Build Configuration variable (see "Set up your API key"
        // above)
        /* apiKey */ BuildConfig.apiKey);
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

Content content =
    new Content.Builder().addText("Write a story about a magic backpack.").build();

// For illustrative purposes only. You should use an executor that fits your needs.
Executor executor = Executors.newSingleThreadExecutor();

ListenableFuture<GenerateContentResponse> response = model.generateContent(content);
Futures.addCallback(
    response,
    new FutureCallback<GenerateContentResponse>() {
      @Override
      public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
      }

      @Override
      public void onFailure(Throwable t) {
        t.printStackTrace();
      }
    },
    executor);
text_generation.java

A seguir

Agora que você está configurado para fazer solicitações à API Gemini, pode usar todos os recursos dela para criar seus apps e fluxos de trabalho. Para começar a usar os recursos da API Gemini, consulte estes guias:

• Geração de texto
• Vision
• Áudio
• Contexto longo

Para conferir a documentação detalhada dos métodos e parâmetros de solicitação da API Gemini, consulte os guias na Referência da API.