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.
Ú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étodo | Rota | O que faz |
|---|---|---|
| GET | /v1/models | Lista os modelos ativos no seu catálogo |
| GET | /v1/me | Saldo, limite e consumo dos últimos 30 dias |
| POST | /v1/chat/completions | Chat, com ou sem streaming |
| GET | /health | Estado 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
| Campo | Obrigatório | O que faz |
|---|---|---|
model | sim | Um dos modelos do catálogo ativo |
messages | sim | Lista de mensagens com role e content |
stream | não | true devolve SSE em vez de JSON único |
temperature | não | Aleatoriedade da resposta; padrão do provedor |
max_tokens | não | Teto de tokens de saída |
tools | não | Ferramentas no formato OpenAI; a execução é do seu código |
stream_options | não | Recebe 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.
| Modelo | Entrada /1M | Saída /1M | Indicado para |
|---|---|---|---|
| glm-5.3-flash-2 | R$ 1,20 | R$ 2,00 | Rápido e barato para classificação, extração e volume |
| glm-5.3-2 | R$ 2,00 | R$ 3,00 | Uso geral com bom custo |
| grok-4.7 | R$ 2,00 | R$ 4,50 | Conversa e raciocínio rápido |
| gpt-6.2-sol | R$ 5,00 | R$ 10,00 | Uso geral equilibrado |
| claude-sonnet-5-5-2 | R$ 7,00 | R$ 40,00 | Código e texto longo |
| claude-sonnet-5-5 | R$ 8,00 | R$ 45,00 | Código e análise |
| gemini-4-argon-2 | R$ 8,00 | R$ 17,00 | Contexto grande e multimodal |
| gpt-6.2-astra | R$ 9,00 | R$ 40,00 | Raciocínio avançado |
| kimi-k3.1-pro | R$ 15,00 | R$ 21,00 | Contexto muito longo |
| claude-opus-5-5-2 | R$ 18,00 | R$ 85,00 | Máxima qualidade |
| claude-fable-5-2 | R$ 35,00 | R$ 175,00 | Escrita criativa premium |
| claude-fable-5-1-2 | R$ 60,00 | R$ 180,00 | Escrita 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-Afterem 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"}}.
| HTTP | code | Quando acontece |
|---|---|---|
| 400 | invalid_request | Faltou o campo `model` ou o JSON é inválido. |
| 400 | model_not_found | O modelo não existe no catálogo ativo. |
| 401 | invalid_api_key | Chave ausente, inválida ou desativada. |
| 402 | insufficient_credit | Saldo zerado. Recarregue para voltar a chamar. |
| 404 | not_found | Rota inexistente. |
| 429 | rate_limit_exceeded | Passou do limite por minuto. Respeite o `Retry-After`. |
| 502 | upstream_error | O provedor do modelo não respondeu. Não há débito. |
| 503 | service_unavailable | Banco 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/.