Este guia de início rápido mostra como começar a usar a API Gemini com o SDK de sua preferência.
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 do cliente para Android descrito neste tutorial permite acessar os modelos 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 Google AI
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, é necessário adicionar 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") }
Sincronize seu projeto do Android com 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 você 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.
Kotlin
// Access your API key as a Build Configuration variable
val apiKey = BuildConfig.apiKey
Java
// Access your API key as a Build Configuration variable
String apiKey = BuildConfig.apiKey;
Para 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 Gemini API Starter
(que inclui o arquivo local.properties
para você começar).
Importar a biblioteca
Importe a biblioteca de IA generativa do Google.
Kotlin
// other imports...
import com.google.ai.client.generativeai.GenerativeModel
Java
// 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.
Kotlin
generateContent()
é uma função de suspensão e precisa ser chamada
de um escopo de corrotina. Se você não conhece as corrotinas, leia Corrotinas
do Kotlin no Android.
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)
Java
generateContent()
retorna um ListenableFuture
. Se você
não conhece essa API, consulte a documentação do Android sobre Como usar um
ListenableFuture
.
// 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);
A seguir
Agora que você está configurado para fazer solicitações à API Gemini, pode usar toda a gama de recursos da API Gemini para criar seus apps e fluxos de trabalho. Para começar a usar os recursos da API Gemini, consulte estes guias:
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.