Documentação

Compatível com
OpenAI.

Troque a base URL e a chave. O resto do seu código continua igual — e a cobrança é por token, em reais.

Base URL /v1Bearer sk-…Streaming SSECompatível com OpenAI

Última atualização: 21 de novembro de 2026 · v1

Base URL: https://api.corebytecnologia.com/v1
Autenticação: Authorization: Bearer sk-sua-chave
Formato: o mesmo da OpenAI — requisição, resposta, erros e streaming.

Início rápido

Você precisa de uma chave ativa e de saldo. A primeira chamada pode ser um curl:

# 1. sua chave
export COREBYTE_KEY="sk-sua-chave"

# 2. uma chamada de chat
curl https://api.corebytecnologia.com/v1/chat/completions \
  -H "Authorization: Bearer $COREBYTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3-flash-2","messages":[{"role":"user","content":"Diga ok"}]}'

Para conferir saldo e limite da chave: GET /v1/me. Para listar os modelos ativos: GET /v1/models.

Autenticação

Toda chamada a /v1/* exige o cabeçalho Authorization: Bearer com a sua chave. A chave começa com sk- e é única por cliente; o saldo e o limite por minuto são da chave, não do sistema que a usa.

Nunca coloque a chave no front-end, em app mobile distribuído ou em repositório público: chame a API pelo seu servidor. Chave vazada deve ser desativada e substituída.

Authorization: Bearer sk-sua-chave

Sem chave ou com chave inválida a resposta é 401 invalid_api_key. Chave desativada também responde 401.

Endpoints

MétodoRotaO que faz
GET/v1/modelsLista os modelos ativos no seu catálogo
GET/v1/meSaldo, limite e consumo dos últimos 30 dias
POST/v1/chat/completionsChat, com ou sem streaming
GET/healthEstado do serviço, sem autenticação

Não há /embeddings, /images nem /responses nesta versão. A rota de chat cobre texto, streaming e tools.

Chat completions

POST /v1/chat/completions recebe o mesmo corpo da OpenAI e repassa ao provedor do modelo escolhido. O débito é feito depois da resposta, com os tokens de usage.

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer sk-sua-chave

{
  "model": "gpt-6.2-sol",
  "messages": [
    {"role": "system", "content": "Responda em português do Brasil."},
    {"role": "user", "content": "Explique o que é uma API em uma frase."}
  ],
  "temperature": 0.7,
  "max_tokens": 200
}

Parâmetros

CampoObrigatórioO que faz
modelsimUm dos modelos do catálogo ativo
messagessimLista de mensagens com role e content
streamnãotrue devolve SSE em vez de JSON único
temperaturenãoAleatoriedade da resposta; padrão do provedor
max_tokensnãoTeto de tokens de saída
toolsnãoFerramentas no formato OpenAI; a execução é do seu código
stream_optionsnãoRecebe include_usage para o último evento trazer o consumo

Campos adicionais aceitos pelo provedor são repassados sem alteração. O limite de corpo da requisição é 10 MB.

Resposta

Sem streaming, a resposta é o JSON da OpenAI. O que importa para a cobrança é usage:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-6.2-sol",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "..."}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 28, "completion_tokens": 57, "total_tokens": 85}
}

O débito é (prompt_tokens ÷ 1.000.000 × preço de entrada) + (completion_tokens ÷ 1.000.000 × preço de saída), com 6 casas decimais. O valor e o modelo aparecem na linha do extrato, ligados ao request id.

Streaming

Com "stream": true a resposta vem como text/event-stream, com linhas data: e o marcador final data: [DONE]. O gateway pede include_usage ao provedor para debitar com o consumo real.

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"Olá"}}]}

data: {"id":"chatcmpl-...","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":8}}

data: [DONE]

O cabeçalho x-request-id traz o identificador da chamada. Se o provedor não devolver usage, o gateway estima os tokens (entrada pelo tamanho do JSON, saída pelos bytes recebidos) e marca a linha como estimated no extrato — nesse caso o valor é aproximado.

Se a conexão cair no meio do stream, o débito usa o que chegou. Não há reconexão automática: implemente retry no cliente, com idempotência do seu lado.

Tools (function calling)

O campo tools segue o formato da OpenAI. O modelo devolve tool_calls; quem executa a função é o seu código, e você devolve o resultado em uma mensagem com role: "tool".

{
  "model": "gpt-6.2-sol",
  "messages": [{"role": "user", "content": "Qual o clima em Brasília?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "clima",
      "description": "Consulta o clima de uma cidade",
      "parameters": {
        "type": "object",
        "properties": {"cidade": {"type": "string"}},
        "required": ["cidade"]
      }
    }
  }]
}

Modelos e preços

São 12 modelos ativos. O preço é por 1 milhão de tokens, com entrada e saída separadas. GET /v1/models devolve a lista ativa.

ModeloEntrada /1MSaída /1MIndicado para
glm-5.3-flash-2R$ 1,20R$ 2,00Rápido e barato para classificação, extração e volume
glm-5.3-2R$ 2,00R$ 3,00Uso geral com bom custo
grok-4.7R$ 2,00R$ 4,50Conversa e raciocínio rápido
gpt-6.2-solR$ 5,00R$ 10,00Uso geral equilibrado
claude-sonnet-5-5-2R$ 7,00R$ 40,00Código e texto longo
claude-sonnet-5-5R$ 8,00R$ 45,00Código e análise
gemini-4-argon-2R$ 8,00R$ 17,00Contexto grande e multimodal
gpt-6.2-astraR$ 9,00R$ 40,00Raciocínio avançado
kimi-k3.1-proR$ 15,00R$ 21,00Contexto muito longo
claude-opus-5-5-2R$ 18,00R$ 85,00Máxima qualidade
claude-fable-5-2R$ 35,00R$ 175,00Escrita criativa premium
claude-fable-5-1-2R$ 60,00R$ 180,00Escrita criativa premium

Ver o catálogo completo, com filtro e casos de uso. No site os nomes aparecem sem o sufixo “-2”; aqui estão os identificadores exatos que a API aceita no campo model.

Preços e disponibilidade: os preços dos modelos podem mudar repentinamente; vale o preço vigente no momento de cada requisição. Quando um modelo for removido, avisaremos com 12 horas de antecedência nas Notificações do console.

Saldo e cobrança

O crédito é pré-pago, em reais. Cada requisição gera uma linha no extrato com modelo, tokens, valor e request id. Consulte o resumo com:

curl https://api.corebytecnologia.com/v1/me \
  -H "Authorization: Bearer $COREBYTE_KEY"
{
  "name": "minha-empresa",
  "balance_brl": 45,
  "rpm_limit": 30,
  "last_30_days": {"spent_brl": 3.42, "requests": 1280}
}

Quando o saldo chega a zero, a API responde 402 insufficient_credit e não chama o provedor. A recarga é por PIX, com nota fiscal para CPF ou CNPJ; os planos e o bônus estão em /precos/.

Limites

  • Requisições por minuto: por chave, padrão de 30 RPM. A resposta 429 traz Retry-After em segundos.
  • Corpo da requisição: até 10 MB.
  • Tamanho de contexto e de saída: definido pelo modelo escolhido; pedir acima do limite devolve erro do provedor.
  • Concorrência: não há fila; chamadas simultâneas contam no mesmo limite por minuto.

Erros

Todo erro segue o formato {"error": {"message", "type", "code"}}.

HTTPcodeQuando acontece
400invalid_requestFaltou o campo `model` ou o JSON é inválido.
400model_not_foundO modelo não existe no catálogo ativo.
401invalid_api_keyChave ausente, inválida ou desativada.
402insufficient_creditSaldo zerado. Recarregue para voltar a chamar.
404not_foundRota inexistente.
429rate_limit_exceededPassou do limite por minuto. Respeite o `Retry-After`.
502upstream_errorO provedor do modelo não respondeu. Não há débito.
503service_unavailableBanco ou serviço indisponível. Tente de novo.

Guarde o request id ao abrir suporte: ele liga a chamada à linha do extrato.

Reembolso e cancelamento

Crédito consumido não é reembolsável. Cada token debitado já foi pago ao provedor do modelo, então não há devolução do que foi usado, mesmo que a resposta não tenha sido boa. Erro nosso debitado por engano é devolvido em crédito.

Crédito não utilizado pode ser devolvido em até 7 dias da compra, conforme o art. 49 do CDC, e depois desse prazo conforme a política completa em /reembolso/. O bônus promocional não é reembolsável. Não existe mensalidade nem fidelidade: você usa enquanto tiver crédito.

Dados e privacidade

O gateway grava, por requisição: chave (em hash), modelo, tokens de entrada e saída, valor debitado, se o consumo foi estimado, request id e horário. O conteúdo das mensagens não é armazenado. O texto trafega para o provedor do modelo para gerar a resposta e segue a política dele.

Dados de cadastro e cobrança são tratados conforme a Política de Privacidade e a LGPD. Para excluir a conta ou tirar dúvidas: contato@corebytecnologia.com.

SDKs e ferramentas

Como o formato é o da OpenAI, o SDK oficial e as ferramentas que falam OpenAI funcionam apenas trocando a base URL.

# Python
pip install openai

from openai import OpenAI
client = OpenAI(base_url="https://api.corebytecnologia.com/v1", api_key="sk-sua-chave")
r = client.chat.completions.create(model="glm-5.3-flash-2",
      messages=[{"role":"user","content":"Diga ok"}])
print(r.choices[0].message.content)
// Node.js
npm install openai

import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.corebytecnologia.com/v1", apiKey: "sk-sua-chave" });
const r = await client.chat.completions.create({
  model: "glm-5.3-flash-2",
  messages: [{ role: "user", content: "Diga ok" }]
});
console.log(r.choices[0].message.content);

Também funciona em n8n (nó OpenAI, com Base URL trocada), Typebot, LangChain, Flowise e qualquer app que aceite uma base URL compatível com OpenAI.

Perguntas

Preciso trocar meu código para usar a API CoreByte?

Basta trocar a base URL para https://api.corebytecnologia.com/v1 e a chave. O formato de requisição e resposta é o da OpenAI, e o SDK oficial funciona sem alterações.

A API guarda o conteúdo das minhas mensagens?

Não. O gateway registra modelo, tokens de entrada e saída, valor debitado e request id. O texto das mensagens não é gravado no banco.

Posso usar a mesma chave em vários sistemas?

Sim, mas o limite por minuto é por chave: divida o volume entre chaves se precisar de limites separados.

O que acontece quando o saldo acaba?

A API responde 402 insufficient_credit e para de debitar. Nada é cobrado além do crédito recarregado.

Crédito não usado expira?

Não há prazo de expiração definido na plataforma. O crédito fica na conta até ser consumido ou devolvido conforme a política de reembolso.

Tem reembolso?

Crédito já consumido em chamadas não é reembolsável, porque o custo do token já foi pago ao provedor. Crédito não utilizado pode ser devolvido em até 7 dias da compra (CDC) e, depois desse prazo, conforme a política em /reembolso/.

Precisa de ajuda?

Mande o request id, o modelo e o horário para contato@corebytecnologia.com ou pelo WhatsApp. O estado do serviço fica em /status/.