Documentazione e endpoint API Codex

URL Base e autenticazione

Invia richieste all'URL di base https://api.codexapipricing.com/v1 utilizzando la tua chiave API. Questo endpoint è compatibile con le SDK standard di OpenAI, quindi devi solo aggiornare l'URL di base e fornire la tua chiave. Autenticati passando l'intestazione Authorization: Bearer YOUR_API_KEY con ogni richiesta. Puoi generare una chiave immediatamente effettuando l'accesso con Google o con email e password. La chiave viene visualizzata una sola volta dopo la creazione, quindi salvala in modo sicuro. I tuoi prompt non vengono utilizzati per l'addestramento, garantendo la privacy dei tuoi dati.

Endpoint Chat completions

Usa il POST /v1/chat/completions endpoint per generare testo. Questa è l'interfaccia principale per l'invio di prompt e la ricezione di risposte. L'ID del modello è sempre uncensored, indipendentemente dalla versione del modello in esecuzione sui nostri server. Puoi controllare i modelli disponibili tramite GET /v1/models. Invia la tua cronologia dei messaggi nel messages

Parametri supportati e modalità JSON

Controlla la generazione con parametri come temperature, top_p, e stop. Usa response_format impostato a {"type": "json_object"} per forzare l'output JSON. Questo è utile per l'estrazione di dati strutturati o il function calling. Puoi anche impostare max_tokens per limitare la lunghezza dell'output, con un valore predefinito di 2.048 se omesso. La finestra di contesto supporta fino a 100.000 token per prompt e completamento combinati. Passa seed per risultati deterministici o presence_penalty e frequency_penalty per regolare la ripetizione. Questi parametri permettono di affinare il comportamento del modello senza configurazioni complesse. La modalità JSON garantisce una formattazione rigorosa per un'analisi affidabile nella tua applicazione.

Risposte in streaming tramite SSE

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) man mano che i token vengono generati. Questo riduce la latenza percepita per le risposte lunghe. I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk dello stream. Puoi elaborare i token in modo incrementale per visualizzare il testo in tempo reale. Questa funzionalità funziona con tutti gli SDK compatibili con OpenAI. Lo streaming è ideale per le interfacce chat dove gli utenti si aspettano feedback immediato. L'ultimo chunk contiene il conteggio totale dei token per una fatturazione accurata. Usa questo metodo per gestire output grandi in modo elegante senza attendere l'intera risposta.

Limiti di frequenza e corpi delle richieste

Ogni chiave API è limitata a 300 richieste al minuto e 8 richieste concorrenti. La dimensione massima del corpo della richiesta è di 8 MB. Se superi questi limiti, ricevi un errore 429. Puoi generare nuove chiavi per sostituire quelle esistenti, ma è attiva solo una chiave per account. Gli errori e i rifiuti non contano contro il tuo limite di frequenza. La finestra di contesto di 100.000 token consente una cronologia delle conversazioni estesa. Mantieni i corpi delle richieste concisi per rimanere entro i limiti di dimensione. Monitora il tuo utilizzo per evitare interruzioni durante le ore di punta. Questi limiti garantiscono un utilizzo equo per tutti i clienti prepagati.

Gestione degli errori e risoluzione dei problemi

Gestisci gli errori controllando il codice di stato HTTP. Un errore 401 indica una chiave API non valida o mancante. Un errore 402 significa che il tuo credito prepagato è esaurito. Un errore 429 segnala che hai superato i limiti di frequenza. Usa il error field nella risposta per ottenere i dettagli. Errori come i doppi addebiti vengono risolti tramite la pagina Supporto. Il credito non scade mai, quindi puoi ricaricare più tardi. I rifiuti per violazioni della policy sui contenuti sono gratuiti. Questa struttura prevedibile degli errori ti aiuta a risolvere rapidamente i problemi di integrazione senza indovinare la causa.

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)