Documentação

Comece em 2 minutos.

A API da Geraikita AI aceita dois formatos ao mesmo tempo: OpenAI Chat Completions e Anthropic Messages. Use o SDK da OpenAI, o SDK da Anthropic, Claude Code CLI, Cline e outras ferramentas — basta trocar a base URL e a chave de API.

Base URL (OpenAI)https://ai.geraikita.com/v1

Base URL (Anthropic)https://ai.geraikita.com

AutenticaçãoBearer gk-... (ou x-api-key: gk-...)

Importante — não escreva /v1 duas vezes.

OpenAIhttps://ai.geraikita.com/v1Clientes OpenAI acrescentam /chat/completions à base URL — então a base termina com /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comClientes Anthropic (Claude Code CLI, SDK Anthropic) acrescentam /v1/messages por conta própria — então a base vai sem /v1.

Se errar, o caminho vira /v1/v1/messages → erro 400.

O nível gratuito (Bansos) usa uma CHAVE SEPARADA — não a sua chave paga.

A chave bansos precisa ser resgatada antes na página do Bansos (login + verificação no Telegram, grátis, uma vez por conta). Uma chave gk- paga do Painel não funciona no endpoint bansos, e vice-versa — misturar as duas retorna 401 unauthorized.

A base URL do bansos também é diferente da paga acima:

Base URL do bansoshttps://ai.geraikita.com/v1/claude

OpenAIhttps://ai.geraikita.com/v1/claude/chat/completions

Anthropic / Claude Code CLIANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeO SDK acrescenta /v1/messages sozinho → https://ai.geraikita.com/v1/claude/v1/messages.

Descoberta de modelosGET https://ai.geraikita.com/v1/claude/models

Todo o resto é exatamente igual ao endpoint pago.

Autenticação

Cada requisição carrega sua chave de API gk- no header Authorization: Bearer gk-.... As chaves são criadas no painel e exibidas apenas uma vez na criação — guarde-as com segurança. Você pode restringir cada chave a modelos específicos (allowlist).

Primeira requisição

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.geraikita.com/v1",
    api_key="gk-xxxxxxxx",
)
resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

Claude Code CLI

O Claude Code usa o formato Anthropic. Configure a base URL como a raiz (https://ai.geraikita.com — sem /v1) e depois execute claude. Use os modelos claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = RAIZ sem /v1 (o Claude Code acrescenta /v1/messages sozinho)
export ANTHROPIC_BASE_URL="https://ai.geraikita.com"
export ANTHROPIC_AUTH_TOKEN="gk-xxxxxxxx"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

Cline e outras ferramentas

Cline / Roo (OpenAI Compatible): provedor OpenAI Compatible, Base URL https://ai.geraikita.com/v1, chave de API gk-..., Model ID claude-sonnet-5.

Cline (Anthropic): provedor Anthropic, Base URL https://ai.geraikita.com, chave de API gk-....

Sua ferramenta descobre modelos automaticamente? O endpoint GET https://ai.geraikita.com/v1/models está disponível. Se houver um campo "Gateway base URL" que acrescenta /v1/models automaticamente, preencha com https://ai.geraikita.com (raiz) para não virar /v1/v1/models.

GeraiPoints

1 GP = Rp1. Você é cobrado por token com base no uso real de cada requisição — sem taxa fixa por requisição, apenas um pequeno mínimo por requisição para cada modelo (piso). Recarregue GeraiPoints no painel; seu saldo nunca expira e vale para qualquer modelo. Sem assinaturas ou cotas mensais.

Lista de modelos

Os valores de model que você pode enviar. Veja a página de preços para as tarifas de cada modelo.

Escreva o nome do modelo EXATAMENTE como listado — sem prefixo. Envie claude-sonnet-5, não gp/claude-sonnet-5 nem openai/claude-sonnet-5. Alguns clientes/CLIs prefixam o modelo com o nome de um provedor (ex.: um perfil chamado gp → o modelo vira gp/claude-sonnet-5) → o resultado é 404 unknown model. O prefixo gk- é para chaves de API (o header Authorization), não para nomes de modelos.

Criar uma chave de API

Abra o Painel → Criar chave de API, dê um nome a ela e (opcionalmente) restrinja-a a modelos específicos. A chave em texto puro é exibida apenas uma vez. Até 5 chaves ativas por conta — revogue uma antiga para criar uma nova.

Códigos de erro

Status	Significado
400	Base URL / body errados — confira se não há /v1 duplicado (ex.: /v1/v1/messages)
401	Chave de API inválida / faixa errada — chave paga ≠ chave bansos. Confira a base URL: a paga usa /v1, o bansos usa /v1/claude
402	GeraiPoints insuficientes — recarregue, por favor
403	Modelo não permitido para esta chave
404	Modelo desconhecido — envie o NOME EXATO DO MODELO (ex.: claude-sonnet-5), sem prefixo. Nomes como gp/claude-sonnet-5 ou openai/... darão 404
429	Requisições demais