Cos'è l'API Codex?
Il termine codex api si riferisce generalmente all'interfaccia utilizzata dai modelli AI addestrati specificamente per la generazione e la comprensione del codice. Popolarizzato originariamente da OpenAI, questo concetto è evoluto in uno standard più ampio in cui vari provider offrono endpoint compatibili con OpenAI. Per gli agenti di codifica AI, questo significa una struttura POST /v1/chat/completions coerente che gestisce le interazioni dati in ingresso e in uscita.
Il nostro servizio offre un modello linguistico di grandi dimensioni dedicato e senza censura, ottimizzato per i contesti di coding. A differenza dei proxy che aggregano più fornitori, eseguiamo un singolo modello a pesi aperti sui nostri server GPU. Questo garantisce un endpoint stabile a modello singolo con una finestra di contesto da 100.000 token, fondamentale per gestire grandi codebase senza perdere il contesto.
L'API non supporta embedding, generazione di immagini, audio o video, né offre fine-tuning. È strettamente un motore di completamento testuale progettato per integrarsi direttamente in agent di codifica come Cursor o Claude Code.
Perché usare un modello senza censura?
I modelli di codifica standard applicano spesso filtri sui contenuti che possono interferire con le attività tecniche. Ad esempio, un modello potrebbe rifiutarsi di generare codice per una vulnerabilità di sicurezza o bloccare la sintassi di un linguaggio di programmazione specifico se ricorda un'opera protetta da copyright, anche quando l'uso è legittimo e tecnico. Un modello senza censura rimuove questi rifiuti arbitrari, consentendo all'agent di concentrarsi esclusivamente sulla qualità e sulla logica del codice.
Il nostro modello è ottimizzato per rispondere senza rifiuti di contenuto per l'uso adulto lecito. Questo è particolarmente utile per gli agenti di codifica AI che devono elaborare frammenti di codice diversificati, documentazione o progetti di codifica creativa senza incontrare un errore 403 Forbidden a causa della policy sui contenuti.
C'è un limite di contenuto rigido che si applica sempre: nessun contenuto sessuale che coinvolga minori. Le richieste di questo tipo vengono bloccate. Per tutti gli altri argomenti legittimi per adulti, di fantasia o di ricerca sulla sicurezza, il modello fornirà una risposta diretta. Questa stabilità riduce la necessità di logica di retry nel flusso di lavoro del tuo agent, risparmiando token e tempo.
Configurazione di Cursor IDE
Cursor IDE è un editor di codice popolare basato sull'AI che si affida a endpoint LLM esterni. Per usare la nostra API senza censura come tuo agent di codifica principale, devi aggiornare l'URL di base nelle impostazioni.
Vai alle impostazioni di Cursor e individua la sezione di configurazione API. Modifica l'URL di base in https://api.getcodexapi.com/v1. Inserisci la tua chiave API dalla pagina Ottieni chiave API. L'ID del modello che dovresti selezionare è uncensored.
Questa configurazione assicura che tutti i suggerimenti di codice e le modifiche vengano elaborati dal nostro modello dedicato. Poiché Cursor utilizza il formato compatibile con OpenAI, non è necessario middleware aggiuntivo. La finestra di contesto da 100.000 token consente all'editor di mantenere il contesto su file di grandi dimensioni o attività di refactoring multi-file, una limitazione comune nei modelli con contesto più piccolo.
Compromesso: Non avrai accesso a modelli proprietari come GPT-4 o Claude a meno che non modifichi manualmente le configurazioni. Tuttavia, per la sola generazione e modifica del codice, questo endpoint senza censura fornisce spesso risultati più veloci e coerenti senza interruzioni dovute alle policy.
Connessione a Claude Code
Claude Code è un agent da riga di comando sviluppato da Anthropic. Sebbene utilizzi tipicamente l'API di Anthropic, può essere configurato per utilizzare qualsiasi endpoint compatibile con OpenAI se il client lo supporta. Questo rende la nostra API un'alternativa valida per gli utenti che preferiscono il comportamento senza censura del nostro modello ma apprezzano l'interfaccia di Claude Code.
Per connetterti, devi assicurarti che il tuo client supporti URL base personalizzati. Aggiorna la configurazione per puntare a https://api.getcodexapi.com/v1 e imposta il modello su uncensored. Dovrai anche fornire la tua chiave API.
Questa configurazione è utile per gli sviluppatori che vogliono le solide capacità di chiamata di strumenti di un agent di codifica ma hanno bisogno di un modello che non rifiuti pattern di codice complessi o insoliti. Nota che mentre l'interfaccia rimane la stessa, il comportamento del modello sottostante differirà dai modelli Claude standard. Testa sempre i tuoi flussi di lavoro specifici per assicurarti che il modello senza censura soddisfi i tuoi standard di qualità del codice.
Uso dell'SDK OpenAI
L'SDK OpenAI per Python o Node.js è progettato per funzionare con qualsiasi endpoint compatibile con OpenAI. Puoi passare alla nostra API modificando l'URL di base e la chiave API.
Ecco come puoi inizializzare il client in Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getcodexapi.com/v1",
api_key="your-api-key"
)
Successivamente, puoi chiamare l'endpoint di completamento chat come al solito:
response = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a Python function to sort a list."}]
)
Questa semplicità ti consente di sostituire il modello sottostante senza riscrivere la logica principale del tuo agent. L'SDK gestisce la serializzazione e l'analisi delle risposte, così puoi concentrarti sulla logica dell'applicazione.
Risposte in streaming per feedback in tempo reale
Per gli agent di codifica che forniscono suggerimenti di codice in tempo reale, lo streaming è essenziale. La nostra API supporta Server-Sent Events (SSE) per lo streaming delle risposte. Questo consente all'agent di visualizzare il codice mentre viene generato, migliorando l'esperienza utente.
- Imposta
stream=Truenella tua richiesta API. - Leggi il flusso a blocchi.
- Aggiorna l'UI o l'editor con ogni chunk.
Questo riduce la latenza percepita, specialmente per blocchi di codice di grandi dimensioni. Poiché il nostro modello ha una finestra di contesto da 100.000 token, puoi trasmettere in streaming risposte che includono grandi quantità di contesto senza preoccuparti del truncamento.
Nota: Lo streaming non modifica il prezzo o il conteggio dei token. I token vengono fatturati in base al totale dei dati in ingresso e in uscita, indipendentemente dal fatto che la risposta venga trasmessa in streaming o restituita in un unico blocco.
Gestione delle chiamate di funzioni
Gli agenti di codifica AI utilizzano spesso la chiamata di funzioni per interagire con strumenti esterni, ad esempio per eseguire un comando nel terminale o leggere un file. La nostra API supporta questa funzionalità, consentendoti di definire gli schemi delle funzioni nella tua richiesta.
- Definisci le tue funzioni nel parametro
functions. - Il modello restituirà una risposta con un oggetto
function_call. - Il tuo agente esegue la funzione e invia il risultato al modello.
- Il modello genera la risposta successiva in base al risultato.
Questa interazione a più turni è cruciale per attività di codifica complesse. Ad esempio, un agente potrebbe dover leggere un file, analizzarlo e poi generare una correzione. La nostra API gestisce questo in modo trasparente, mantenendo il contesto attraverso più turni entro il limite di 100.000 token.
Gestione dei limiti di richieste
Per garantire un utilizzo equo e la stabilità, la nostra API applica un limite di 300 richieste al minuto per chiave. La dimensione massima del corpo della richiesta è di 8 MB. Se superi questi limiti, riceverai un errore 429 Too Many Requests.
Best practices:
- Implementa un backoff esponenziale nella logica di retry del tuo agente.
- Usa lo streaming per ridurre il numero di chiamate API per le risposte di grandi dimensioni.
- Monitora il tuo utilizzo tramite la dashboard per evitare addebiti imprevisti.
Se devi ruotare le chiavi, puoi rigenerare la tua chiave API in qualsiasi momento. Questo revoca la vecchia chiave, quindi assicurati di aggiornare i tuoi agenti prima di rigenerarla.
