GeraikitaGeraikita AI
MenuAutenticação

Autenticação

Cada requisição é autenticada com a sua chave de API, que começa com gk-. O custo é descontado do saldo de GeraiPoints da conta dona da chave.

Enviar a chave de API

Envie a chave em um dos headers abaixo. Os dois funcionam em todos os endpoints pagos.

HeaderFormatoObservações
AuthorizationBearer gk-…Padrão dos clientes no formato OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Padrão dos clientes no formato Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01Enviado automaticamente pelo SDK da Anthropic; inclua-o se chamar /v1/messages diretamente.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Se a chave não for enviada, estiver errada ou tiver sido revogada, o servidor responde 401 com type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Criar e revogar chaves

  1. Abra o Painel e escolha Criar API key.
  2. Dê um nome que descreva o uso (por exemplo laptop-kantor ou server-produksi) e, se necessário, escolha os modelos permitidos.
  3. Copie a chave e guarde-a em local seguro. Para revogar, clique em Revogar na lista de chaves: requisições com essa chave passam a ser recusadas na hora.
A chave completa só é exibida uma vez, no momento da criação, e não pode ser vista de novo. Máximo de 20 chaves ativas por conta: revogue uma chave antiga para criar uma nova.

Restringir uma chave a modelos específicos

Cada chave pode ser restrita a uma lista de modelos específicos (allowlist). Lista vazia significa que todos os modelos são permitidos. Requisições a modelos fora da lista recebem 403 permission_error, e GET /v1/models com essa chave mostra apenas os modelos permitidos. Use isso em chaves compartilhadas com apps ou equipes para manter os gastos sob controle.

Tipos de chave

ChaveUsoBase URL
gk-API paga — descontada dos GeraiPoints. Criada no Painel.https://ai.geraikita.com/v1
gk- (bansos)Nível gratuito — cota diária, endpoint separado. Veja Nível gratuito (Bansos). Não funciona nos endpoints pagos, e vice-versa.https://ai.geraikita.com/v1/claude
gkr-Programa de revenda — gerenciado na página Reseller.—

Manter a chave segura

  • Não coloque a chave em código front-end (navegador, apps móveis). Chame a API a partir do seu próprio servidor.
  • Guarde a chave em variáveis de ambiente ou em um gerenciador de segredos, e nunca faça commit dela em um repositório.
  • Use uma chave por app ou dispositivo, para acompanhar o uso com facilidade e poder revogar uma chave sem afetar as outras.
  • Suspeita de vazamento? Revogue a chave imediatamente no Painel e crie uma nova.