KillaIA / DOCS
Guia de integração

Uma chave. Todos os caminhos.

Use sua chave KillaIA com o protocolo Anthropic ou OpenAI-compatible. Os exemplos começam em Fable-5-1M com esforço xhigh.

model Fable-5-1Mcontexto 1Meffort xhighoutput 131.072streaming SSE

Visão geral

Você recebe uma chave sk-killaia-…. Ela autentica chamadas no domínio KillaIA; a credencial do provedor principal nunca precisa aparecer no seu editor ou código.

Anthropic nativo

Use /v1/messages. Indicado para Claude Code e SDK Anthropic.

OpenAI-compatible

Use /v1/chat/completions quando a ferramenta aceita Base URL OpenAI personalizada.

Default inteligente: omitir model seleciona Fable-5-1M, encaminhado ao ID operacional validado Fable-5. O gateway sempre aplica output_config.effort=xhigh ao Fable 5. A janela de contexto de 1M é diferente da saída máxima de 131.072 tokens.

Claude Code

Configure no terminal que abrirá o Claude Code. Use ANTHROPIC_AUTH_TOKEN, não ANTHROPIC_API_KEY, para autenticação Bearer.

Terminal · macOS / Linux
# Remova uma chave Anthropic direta que possa sobrescrever o gateway
unset ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL="https://aquinaoticotico.cloud"
export ANTHROPIC_AUTH_TOKEN="sk-killaia-SUA-KEY"
export ANTHROPIC_MODEL="Fable-5-1M"
export CLAUDE_CODE_EFFORT_LEVEL="xhigh"
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="131072"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"
export ANTHROPIC_CUSTOM_MODEL_OPTION="Fable-5-1M"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Fable 5 · 1M — KillaIA"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Modelo principal KillaIA com contexto de 1M e esforço xhigh"
claude --model "Fable-5-1M" --effort "xhigh"
  1. Troque a chave
    Substitua somente sk-killaia-SUA-KEY.
  2. Abra o projeto
    Execute no mesmo terminal em que as variáveis foram exportadas.
  3. Confirme o modelo
    Fable-5-1M deve aparecer como opção personalizada.

cURL

Use estes testes antes de configurar um editor.

Anthropic Messages
curl https://aquinaoticotico.cloud/v1/messages \
  -H "Authorization: Bearer sk-killaia-SUA-KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"Fable-5-1M","max_tokens":131072,"output_config":{"effort":"xhigh"},"messages":[{"role":"user","content":"Olá"}]}'
OpenAI Chat Completions
curl https://aquinaoticotico.cloud/v1/chat/completions \
  -H "Authorization: Bearer sk-killaia-SUA-KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Fable-5-1M","max_tokens":131072,"messages":[{"role":"user","content":"Olá"}]}'
Listar modelos
curl "https://aquinaoticotico.cloud/v1/models" -H "Authorization: Bearer sk-killaia-SUA-KEY"

Python

Instale o SDK oficial e informe a Base URL do gateway.

Instalação
pip install anthropic
Python · Anthropic SDK
from anthropic import Anthropic

client = Anthropic(base_url="https://aquinaoticotico.cloud", api_key="sk-killaia-SUA-KEY")
message = client.messages.create(
    model="Fable-5-1M",
    max_tokens=131072,
    output_config={"effort": "xhigh"},
    messages=[{"role": "user", "content": "Olá"}],
)
print(message.content[0].text)

TypeScript / Node.js

O mesmo contrato funciona no SDK Anthropic para Node.

Instalação
npm install @anthropic-ai/sdk
TypeScript · Anthropic SDK
import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({ baseURL: 'https://aquinaoticotico.cloud', apiKey: 'sk-killaia-SUA-KEY' })
const message = await client.messages.create({
  model: 'Fable-5-1M',
  max_tokens: 131072,
  output_config: { effort: 'xhigh' },
  messages: [{ role: 'user', content: 'Olá' }],
})
console.log(message.content)

Cursor

Em Settings → Models, configure um provedor OpenAI customizado. Os nomes das telas podem variar entre versões.

Cursor · campos
{
  "title": "Cursor — OpenAI Compatible",
  "provider": "openai-compatible",
  "apiBase": "https://aquinaoticotico.cloud/v1",
  "apiKey": "sk-killaia-SUA-KEY",
  "model": "Fable-5-1M"
}
O endpoint final deve terminar em /v1/chat/completions. Evite duplicar /v1.

Cline / Roo Code

Prefira Anthropic quando houver Base URL personalizada; o formato exige menos tradução.

Cline · settings
{
  "provider": "openai-compatible",
  "apiBase": "https://aquinaoticotico.cloud/v1",
  "apiKey": "sk-killaia-SUA-KEY",
  "model": "Fable-5-1M"
}
Roo Code · campos
{
  "title": "Roo Code — OpenAI Compatible",
  "settings_json": {
    "apiProvider": "openai-compatible",
    "openAiBaseUrl": "https://aquinaoticotico.cloud/v1",
    "openAiApiKey": "sk-killaia-SUA-KEY",
    "model": "Fable-5-1M"
  }
}

Kilo Code

As duas opções abaixo usam a mesma chave de cliente.

Kilo · Anthropic
{
  "title": "Kilo Code — Anthropic",
  "provider": "Anthropic",
  "api_provider": "anthropic",
  "baseUrl": "https://aquinaoticotico.cloud",
  "apiKey": "sk-killaia-SUA-KEY",
  "model": "Fable-5-1M"
}
Kilo · OpenAI-compatible
{
  "title": "Kilo Code — OpenAI Compatible",
  "provider": "OpenAI Compatible",
  "api_provider": "openai-compatible",
  "baseUrl": "https://aquinaoticotico.cloud/v1",
  "apiKey": "sk-killaia-SUA-KEY",
  "model": "Fable-5-1M"
}

Continue

Adicione o modelo ao arquivo de configuração com o provider OpenAI-compatible.

Continue · config
{
  "title": "VS Code / Continue — OpenAI Compatible",
  "provider": "openai",
  "apiBase": "https://aquinaoticotico.cloud/v1",
  "apiKey": "sk-killaia-SUA-KEY",
  "model": "Fable-5-1M",
  "models": [
    {
      "title": "KillaIA · Fable 5 · 1M",
      "provider": "openai",
      "model": "Fable-5-1M",
      "apiBase": "https://aquinaoticotico.cloud/v1",
      "apiKey": "sk-killaia-SUA-KEY"
    }
  ]
}

Modelos

Use os IDs exatamente como publicados. O fallback local contém Fable-5-1M, o alias compatível claude-fable-5 e o alias legado Fable-5. Todos apontam ao ID operacional Fable-5; os demais modelos Claude vêm da descoberta do upstream.

ID públicoEncaminhamentoContextoPadrão
Fable-5-1MFable-51.000.000Sim
claude-fable-5Fable-51.000.000Não
Fable-5Fable-51.000.000Legado
Consulte GET /v1/models com sua chave. Limites, capacidades e preço dos modelos descobertos ficam ausentes quando não foram confirmados.

Solução de erros

401 — chave inválida

Confirme a chave KillaIA no header Authorization: Bearer. No Claude Code, remova ANTHROPIC_API_KEY para evitar precedência indevida.

404 — endpoint duplicado

Use os contratos canônicos /v1/messages e /v1/chat/completions. Aliases duplicados permanecem temporariamente e respondem com o header Deprecation.

429 — limite atingido

Pode indicar RPM, quota ou concorrência. Aguarde o retry_after quando presente; retries devem usar backoff com jitter. A quota mensal segue UTC.

400 — conteúdo OpenAI não suportado

O v1 traduz texto, system/developer, tools e tool results. Imagens, áudio e tipos desconhecidos retornam erro explícito.

Modelo não encontrado

Consulte /v1/models e preserve maiúsculas, espaços e pontuação do ID.

Streaming interrompido

Confirme que o proxy reverso não aplica buffering a text/event-stream. O gateway emite evento de erro quando ainda é possível escrever.

Segurança

Não coloque chaves em repositórios, screenshots, logs ou frontend. Crie uma por pessoa, ferramenta ou ambiente.

Rotação: se uma chave for exposta, revogue e gere outra. A KillaIA armazena somente o hash das chaves após a criação.