Saltar para o conteúdo principal

​
Introdução

Gemini é um serviço de chat AI fornecido pela Ace Data Cloud, baseado na série de grandes modelos de linguagem Google Gemini. Através da API unificada da Ace Data Cloud, você pode integrar rapidamente o Gemini usando JavaScript, implementando funcionalidades como diálogo multi-turno, prompts do sistema, saída em streaming, modo de saída JSON, entre outras.

​
Pré-requisitos

  • Ter uma conta na Ace Data Cloud e obter um Token de API
  • Node.js 18+ ou ambiente de navegador moderno

​
Uso Básico

O endpoint principal para chamar a API Gemini é: 
POST https://api.acedata.cloud/gemini/chat/completions
Este exemplo usa o modelo gemini-2.5-flash.
Modelos disponíveis incluem: gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-3.0-pro. Exemplo completo de código JavaScript: 
const response = await fetch("https://api.acedata.cloud/gemini/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gemini-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下你自己"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}),
});

const result = await response.json();
console.log(result);
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento de Resposta

Recomenda-se verificar o código de status da resposta e tratar erros: 
if (response.ok) {
  const result = await response.json();
  console.log("Chamada bem-sucedida:", result);
} else {
  console.error(`Falha na chamada, código de status: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulamento em Node.js

Recomenda-se encapsular em uma função reutilizável: 
async function callGemini(data) {
  const response = await fetch("https://api.acedata.cloud/gemini/chat/completions", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Erro na API: ${response.status}`);
  return response.json();
}

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o Token de API
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Próximos Passos