Como usar GPT-6 Astra com a OmniaKey

Este tutorial leva você de uma conta nova na OmniaKey até a primeira solicitação bem-sucedida ao GPT-6 Astra. Ele cobre chamadas de API no servidor e o Codex CLI. Uma chave API da OmniaKey não é uma assinatura do ChatGPT e não pode ser inserida no site do ChatGPT.

O guia atual da OpenAI para Astra começa pela Responses API. Chat Completions continua disponível para texto simples, mas as chamadas de ferramentas do Astra exigem Responses. Os exemplos abaixo respeitam esse limite e leem a chave de uma variável de ambiente em vez de colocá-la no código-fonte.

Antes de começar

Crie uma chave API com escopo limitado

Entre na OmniaKey e abra a página de chaves API. Crie uma chave separada para esta integração e defina cota e expiração adequadas ao teste. Copie a chave assim que ela aparecer.

A conta também precisa de saldo utilizável. Criar uma chave comprova que a credencial existe, mas não que a conta consegue financiar uma solicitação.

Trate a chave como uma senha. Não faça commit no Git, não a coloque em uma aplicação no navegador e não a inclua em capturas de tela ou conversas.

Coloque a chave em uma variável de ambiente

No macOS ou Linux:

export OMNIAKEY_API_KEY="your-omniakey-api-key"

No PowerShell:

$env:OMNIAKEY_API_KEY="your-omniakey-api-key"

Os exemplos de SDK e Codex abaixo leem essa mesma variável.

Faça a primeira solicitação à Responses API

Execute esta solicitação em um terminal:

curl https://api.omniakey.com/v1/responses \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning": {"effort": "medium"},
    "input": "Revise este plano de migração. Retorne os dois maiores riscos e um teste de aceitação para cada um."
  }'

Uma resposta bem-sucedida contém o array output, texto gerado e uso de tokens. Essa primeira chamada verifica em conjunto Base URL, chave, saldo, permissão do modelo, ID do modelo e rota Responses.

Depois do sucesso, abra o painel de uso e confirme que o modelo registrado é gpt-6-astra. Revise os usos reais de entrada, cache, raciocínio e saída em vez de estimar o custo apenas pelo texto visível.

Chame o Astra pelo Python

Instale ou atualize o SDK oficial da OpenAI para Python:

python -m pip install --upgrade openai

Crie astra_example.py:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OMNIAKEY_API_KEY"],
    base_url="https://api.omniakey.com/v1",
)

response = client.responses.create(
    model="gpt-6-astra",
    reasoning={"effort": "medium"},
    input="Explique este relatório de incidente e liste as três verificações seguintes mais úteis.",
)

print(response.output_text)

Execute:

python astra_example.py

response.output_text é o campo de conveniência do SDK para o texto gerado. Guarde a resposta completa se você também precisar de uso, status ou itens de chamada de ferramenta.

Chame o Astra pelo Node.js

Instale o SDK:

npm install openai

Crie um arquivo de servidor como astra-example.mjs:

import OpenAI from "openai";

const apiKey = process.env.OMNIAKEY_API_KEY;
if (!apiKey) throw new Error("OMNIAKEY_API_KEY is required");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.omniakey.com/v1",
});

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "medium" },
  input: "Revise este design de API. Encontre dois modos de falha e um teste para cada um.",
});

console.log(response.output_text);

Execute a partir do shell onde a variável de ambiente foi definida:

node astra-example.mjs

Execute esse código em um servidor, máquina local ou worker confiável. Uma chave incluída em um bundle de frontend fica exposta aos visitantes.

Use GPT-6 Astra no Codex CLI

Um provider personalizado do Codex utiliza o Responses wire format. Adicione o conteúdo abaixo ao arquivo de usuário ~/.codex/config.toml:

model = "gpt-6-astra"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

Inicie o Codex em um shell com a chave definida:

export OMNIAKEY_API_KEY="your-omniakey-api-key"
codex

Deixe requires_openai_auth sem definir. A referência oficial de configuração do Codex o define como sinalizador de autenticação OpenAI; este provider personalizado se autentica por env_key.

Confira primeiro o modelo exibido pelo Codex e execute uma pequena tarefa somente de leitura antes de permitir alterações. Se uma chamada cURL direta funcionar e o Codex falhar, verifique primeiro a configuração do cliente.

Use Chat Completions apenas quando o cliente precisar

GPT-6 Astra também aceita texto simples por Chat Completions. Use esta rota se o cliente ainda não oferece Responses:

curl https://api.omniakey.com/v1/chat/completions \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning_effort": "medium",
    "messages": [
      {"role": "user", "content": "Resuma os dois principais riscos deste plano de implantação."}
    ]
  }'

Observe a diferença do parâmetro: Responses usa reasoning.effort, enquanto Chat Completions usa reasoning_effort. Não adicione ferramentas do Astra a este exemplo de Chat Completions. O guia atual da OpenAI exige Responses para chamadas de ferramentas do Astra.

Escolha o reasoning effort

Astra aceita low, medium, high, xhigh e max, mas não none. Um effort maior pode aumentar raciocínio, latência e cobrança de tokens de saída sem garantir uma resposta correta. Use o menor valor que passar no teste de aceitação.

Dê ao Astra uma tarefa verificável

Um bom primeiro prompt declara objetivo, contexto relevante, restrições e verificação de conclusão:

Objetivo: revisar o risco de implantação desta migração de banco de dados.
Contexto: PostgreSQL 15, um único writer em produção, rollback deve terminar em até cinco minutos.
Restrições: não sugerir comandos destrutivos; separar fatos verificados de suposições.
Concluído quando: retornar os três maiores riscos, uma mitigação e um teste de aceitação para cada um.

Para trabalho de código, informe também as regras do repositório e o comando exato que comprova a conclusão. Astra segue atentamente os arquivos de instruções acessíveis; portanto, revise AGENTS.md, skills e arquivos semelhantes antes de liberar acesso a ferramentas.

Corrija erros comuns de configuração

401, unauthorized ou chave API inválida

Confirme se OMNIAKEY_API_KEY está definida no mesmo shell que executa o comando. A variável de ambiente contém apenas a chave; Bearer pertence somente ao cabeçalho HTTP. Confira também se a chave está ativa e não expirou.

Saldo ou cota insuficiente

Verifique o saldo da conta e a cota própria da chave. Uma conta com saldo ainda pode falhar quando a chave limitada atinge o teto.

Modelo não encontrado ou indisponível

Use o ID exato gpt-6-astra. Abra a página atual do modelo e confirme que a chave tem permissão para usá-lo. Nomes de exibição como GPT 6 não são IDs de API.

Parâmetro não compatível

Remova temperature, top_p e top_logprobs. Em Chat Completions, remova também logprobs; no include de Responses, retire message.output_text.logprobs. Astra não oferece suporte a esses parâmetros.

Resposta incomplete ou sem texto visível

Aumente max_output_tokens e confira output_tokens_details.reasoning_tokens. Os tokens de raciocínio consomem o orçamento de saída antes da conclusão da resposta visível.

O chat funciona, mas as ferramentas falham

Mova o fluxo para /v1/responses. Comece com uma chamada Responses de texto simples, depois adicione uma ferramenta por vez e verifique solicitação, resultado, timeout e caminho de permissões. A lista oficial da OpenAI descreve a capacidade direta do modelo; um gateway ou cliente pode expor uma superfície menor.

Codex continua usando outro modelo

Confira model, model_provider, base_url, env_key e wire_api na configuração ativa do Codex. Depois, reinicie o Codex no shell onde OMNIAKEY_API_KEY está definida.

Verifique o custo antes da produção

Execute uma tarefa representativa, confirme o registro de uso e inclua as novas tentativas no custo total. A página do modelo Astra mantém o preço atual da OmniaKey. A análise do Astra separa os preços do gateway das tarifas diretas da OpenAI e explica o limite de 272K dessas tarifas.

Se um limite interrompeu seu trabalho, o guia de limite de uso do Codex mostra como consultar a renovação e comparar créditos extras, outro plano e API local com cobrança separada.

Referências

Todas as fontes oficiais da OpenAI abaixo estão em inglês. Os links da documentação da OmniaKey também levam atualmente a páginas em inglês.

• OpenAI: modelo GPT-6 Astra
• OpenAI: guia de uso do GPT-6 Astra
• OpenAI: referência de configuração do Codex
• Início rápido da API OmniaKey (em inglês)
• API compatível com OpenAI da OmniaKey (em inglês)
• Guia do Codex CLI da OmniaKey (em inglês)