Documentação e endpoints da API Codex

URL Base e autenticação

Envie requisições para a URL base https://api.codexapipricing.com/v1 usando sua chave de API. Este endpoint é compatível com SDKs padrão da OpenAI, então você só precisa atualizar o base URL e fornecer sua chave. Autentique-se passando o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação. Você pode gerar uma chave imediatamente fazendo login com Google ou e-mail e senha. A chave é exibida uma única vez após a criação, então guarde-a com segurança. Seus prompts não são usados para treinamento, garantindo a privacidade dos seus dados.

Endpoint de completions de chat

Use o POST /v1/chat/completions endpoint para gerar texto. Esta é a interface principal para enviar prompts e receber respostas. O ID do modelo é sempre uncensored, independentemente da versão do modelo executada em nossos servidores. Você pode verificar os modelos disponíveis via GET /v1/models. Envie seu histórico de mensagens no messages

Parâmetros suportados e modo JSON

Controle a geração com parâmetros como temperature, top_p, e stop. Use response_format definido para {"type": "json_object"} para forçar a saída JSON. Isso é útil para extração de dados estruturados ou chamada de funções. Você também pode definir max_tokens limitar o comprimento da saída, com padrão de 2.048 se omitido. A janela de contexto suporta até 100.000 tokens para prompt e conclusão combinados. Passe seed para resultados determinísticos ou presence_penalty e frequency_penalty para ajustar a repetição. Esses parâmetros permitem o ajuste fino do comportamento do modelo sem configuração complexa. O modo JSON garante formatação estrita para análise confiável no seu aplicativo.

Respostas em streaming via SSE

Ative o streaming definindo stream: true na sua solicitação. A API retorna Eventos Enviados pelo Servidor (SSE) conforme os tokens são gerados. Isso reduz a latência percebida para respostas longas. Detalhes do uso de tokens aparecem no último fragmento do fluxo. Você pode processar tokens incrementalmente para exibir o texto em tempo real. Este recurso funciona com todos os SDKs compatíveis com OpenAI. O streaming é ideal para interfaces de chat onde os usuários esperam feedback imediato. O último fragmento contém a contagem total de tokens para precisão no faturamento. Use este método para lidar com grandes saídas com graça sem esperar pela resposta completa.

Limites de taxa e corpos de solicitação

Cada chave de API está limitada a 300 solicitações por minuto e 8 solicitações simultâneas. O tamanho máximo do corpo da solicitação é de 8 MB. Se você exceder esses limites, receberá um erro 429. Você pode gerar novas chaves para substituir as existentes, mas apenas uma chave está ativa por conta. Erros e recusas não contam contra seu limite de taxa. A janela de contexto de 100.000 tokens permite um histórico extenso de conversas. Mantenha os corpos das solicitações concisos para permanecer dentro dos limites de tamanho. Monitore seu uso para evitar interrupções durante horários de pico. Esses limites garantem uso justo para todos os clientes pré-pagos.

Tratamento de erros e solução de problemas

Lide com erros verificando o código de status HTTP. Um erro 401 indica uma chave de API inválida ou ausente. Um erro 402 significa que seu crédito pré-pago está esgotado. Um erro 429 sinaliza que você excedeu os limites de taxa. Use o error field in the response to get details. Mistakes like double charges are fixed via the Support page. Credit never expires, so you can top up later. Refusals for content policy violations are free. This predictable error structure helps you debug integration issues quickly without guessing the cause.

cURL

Copycurl https://api.codexapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the hourly rates for the large model."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.codexapipricing.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)