Cortex IAby GeHost
API para desenvolvedores

Leve o Cortex para o seu projeto.

Um endpoint compatível com o formato da OpenAI, usando a mesma conta e o mesmo controle de uso do ecossistema Cortex.

Abrir minha chaveVer início rápido
01

Sua chave já nasce com a conta.

Ao criar uma conta ou entrar pela primeira vez, o Cortex emite uma chave pessoal no formato sk-…. Você não precisa inventar uma chave manualmente.

  1. Entre no Cortex Web.
  2. Abra Minha conta → API.
  3. Toque em Exibir minha chave e copie somente quando for configurar seu projeto.
Uma credencial da conta.A chave também identifica sua conta nos serviços Cortex. Se ela vazar, outra pessoa pode consumir seus créditos e acessar recursos autenticados. Trate-a como senha.
02

Primeira resposta em poucos passos.

cURL
curl https://cortex.gehost.com.br/v1/chat/completions \
  -H "Authorization: Bearer $CORTEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Cortex",
    "messages": [{"role": "user", "content": "Explique este projeto em uma frase."}],
    "reasoning_effort": "medium",
    "stream": false
  }'
Python · SDK OpenAI
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CORTEX_API_KEY"],
    base_url="https://cortex.gehost.com.br/v1",
)
response = client.chat.completions.create(
    model="Cortex",
    messages=[{"role": "user", "content": "Olá, Cortex!"}],
)
print(response.choices[0].message.content)
03

Endpoints públicos suportados.

GET/v1/models

Lista os modelos que esta credencial pode usar.

POST/v1/chat/completions

Gera respostas de texto, com streaming, raciocínio e ferramentas no formato compatível.

Use sempre o que /v1/models devolver. O catálogo pode mudar conforme disponibilidade, plano e capacidades da conta.

04

O que a integração libera.

Texto e streaming

Resposta completa ou eventos incrementais com stream: true.

Raciocínio

reasoning_effort: off, low, medium, high ou xhigh, quando o modelo oferecer.

Ferramentas

tools e tool_choice seguem o formato de chat compatível.

Contexto

Envie o histórico necessário em messages; seu projeto não é anexado automaticamente.

API não é controle remoto.A chave dá acesso ao motor. Arquivos locais, terminal, navegador do computador e MCP local só existem quando um cliente Cortex autorizado oferece essas ferramentas.
05

Uso externo é separado do chat.

Chamadas feitas por projeto, editor ou automação entram no contador de uso externo. A conta pode ter uma franquia diária; depois dela, o Cortex exige créditos e cobra conforme os tokens do modelo. Se não houver saldo, a API responde 402 antes de iniciar uma nova geração.

Consulte os valores e seu saldo em Minha conta → Uso. Administradores seguem a política administrativa da conta.

06

Use a chave sem colocá-la em risco.

  • Guarde em variável de ambiente ou cofre de segredos.
  • Nunca coloque a chave no endereço da página, no JavaScript público ou no aplicativo distribuído ao cliente.
  • Não envie a chave em prints, chats, tickets ou repositórios.
  • Faça as chamadas no seu servidor quando o projeto tiver frontend público.
  • Se suspeitar de vazamento, interrompa a integração e solicite a troca; os aparelhos poderão precisar reconectar.