GeraikitaGeraikita AI
MenuInício rápido

Início rápido

Do zero à primeira resposta em três passos: prepare a base URL, crie uma chave de API e envie a requisição.

Base URL

Clientes no formato OpenAI usam uma base URL que termina em /v1. Clientes no formato Anthropic usam a raiz sem /v1, porque o SDK deles acrescenta /v1/messages sozinho.

ConfiguraçãoValorUsado por
base_urlhttps://ai.geraikita.com/v1SDK da OpenAI, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue
base_urlhttps://ai.geraikita.comSDK da Anthropic, Claude Code CLI, Cline (Anthropic)
api_keygk-…Todos os clientes — a chave é criada no Painel

Criar uma chave de API

  1. Entre na Geraikita AI.
  2. Adicione GeraiPoints na página Recarregar (ou resgate uma chave gratuita no Bansos).
  3. Abra o Painel → Criar API key. Copie a chave gk-…: a chave completa só é exibida uma vez.
Guarde a chave em uma variável de ambiente, por exemplo export GERAIKITA_API_KEY=gk-…, em vez de escrevê-la direto no código.

Primeira requisição

Escolha a linguagem ou o SDK que você usa. Todos os exemplos chamam o modelo claude-sonnet-5; troque-o por outro id da lista de modelos.

curl https://ai.geraikita.com/v1/chat/completions \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

A resposta vem no mesmo formato JSON da API da OpenAI (ou da Anthropic, se você usar /v1/messages), incluindo o objeto usage com o número de tokens cobrados.

Resposta em stream

Para respostas longas e ferramentas agênticas, ative stream para que os trechos da resposta cheguem na hora. O servidor envia os headers imediatamente e sinais de keepalive enquanto espera o primeiro token. Defina o timeout do seu app para pelo menos 300 segundos.

curl https://ai.geraikita.com/v1/chat/completions -N \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

Próximos passos