IT ▾
Ottieni la chiave API

Alternative all'API OpenAI: cosa cambia nel tuo codice

La maggior parte delle alternative all'API OpenAI copia il formato delle richieste OpenAI, il che significa che il passaggio è spesso solo una modifica di configurazione. Questo articolo mostra esattamente cosa cambia nel codice, cosa può rompersi e dove un endpoint a modello singolo compatibile con OpenAI è una buona scelta e dove non lo è.

Aggiornato

Cavi colorati collegati a una singola porta di connettore standard, che mostrano endpoint API intercambiabili
Quattro piattaforme con cloud, hub di rete, box GPU e cubo collegati a un saldo centrale, per confrontare le opzioni dei modelli

Cosa offre un'alternativa

Le persone cercano alternative all'API OpenAI per motivi diversi: prezzo, regole sui contenuti, gestione dei dati, disponibilità regionale o il desiderio di usare modelli a pesi aperti. Qualunque sia il motivo, vale lo stesso test. L'alternativa accetta la forma della richiesta che invii già ora e restituisce la forma della risposta che il tuo codice legge già?

Se sì, le chiamate del tuo SDK non cambiano. Se no, scrivi un adattatore una volta, il che è comunque accettabile, ma è il costo principale del passaggio. Il resto di questo articolo presuppone il primo caso, un endpoint compatibile con OpenAI.

La modifica su tre righe

Con il pacchetto Python ufficiale, la configurazione originale prevede l'host predefinito e una chiave OpenAI. Per un'alternativa devi impostare tre cose: base_url, la chiave del nuovo fornitore e il nome del modello. Ecco la versione finita per questo endpoint:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",  # was the default host
    api_key=os.environ["NEW_PROVIDER_KEY"],            # was your OpenAI key
)

r = client.chat.completions.create(
    model="uncensored",                                 # was an OpenAI model name
    messages=[{"role": "user", "content": "Pitch me a plot twist for a mystery."}],
)
print(r.choices[0].message.content)

Lo stesso vale per Node passando baseURL al costruttore, nei wrapper in stile LangChain tramite l'opzione del loro URL di base e negli strumenti che hanno un campo endpoint personalizzato. In curl modifichi l'host e l'intestazione:

curl https://api.uncensoredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $NEW_PROVIDER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Cosa può rompersi dopo il passaggio

Nomi dei modelli

Gli ID dei modelli appartengono al provider. Qualsiasi codice che codifica in modo fisso un nome di modello OpenAI deve essere aggiornato. Inserisci il nome nella configurazione.

Parametri

Le opzioni principali come temperature, top_p, stop e max_tokens si trasferiscono. Altre, come logprobs o alcune opzioni di response-format, dipendono dal fornitore. Su questo endpoint temperature, top_p, stop, seed e le penalità vengono passate attraverso, e la modalità JSON funziona con response_format: {"type":"json_object"}.

Qualità della chiamata di funzioni

Il formato wire è condiviso, ma quanto bene un modello sceglie gli strumenti e compila gli argomenti varia. Esegui i tuoi veri schemi di strumenti sul nuovo modello e valida gli argomenti nel tuo codice.

Lunghezza del contesto e troncamento

Una modifica della finestra di contesto cambia la quantità di cronologia che puoi inviare. Qui la finestra è di 100.000 token per prompt più completamento.

Errori e limiti

I fornitori usano limiti e codici diversi. Questo restituisce HTTP 429 con rate_limited per le richieste al minuto e concurrency per troppi insieme, e un 429 con Retry-After: 5 in caso di sovraccarico temporaneo. La tua logica di retry dovrebbe gestire il 429 per qualsiasi fornitore.

Comportamento

Il cambiamento più grande non è tecnico. I modelli differiscono per tono, abitudini di formattazione e cosa rifiutano. Testa con i tuoi prompt reali, non quelli demo.

Dove si adatta un endpoint a modello singolo

Questo servizio è un'API testuale compatibile con OpenAI con un unico modello a pesi aperti, gestita da un provider indipendente e ottimizzata per rispondere senza filtri sui contenuti per uso adulto legale. Non è l'API ufficiale di OpenAI, Meta, Mistral, Qwen, DeepSeek, xAI, Google, Anthropic o di qualsiasi altro fornitore, e non è un router tra fornitori. L'ID del modello è uncensored.

Si adatta bene a questi compiti: strumenti di finzione e roleplay per adulti, app companion, assistenti di scrittura che non dovrebbero interrompersi a metà scena e backend dove un comportamento stabile su temi maturi è più importante che scegliere tra molti modelli. Si adatta anche agli sviluppatori che vogliono un prezzo semplice per token e prompt che non vengono usati per l'addestramento.

Dove non si adatta

Sii onesto sui limiti prima di spostare il traffico:

  • Un solo modello. Non puoi scegliere un modello più piccolo ed economico per compiti facili o uno più grande per quelli difficili. Se ti affidi al routing dei modelli, hai bisogno di una piattaforma diversa.
  • Solo testo. Nessuna generazione di immagini, audio o video, nessun embedding e nessun fine-tuning. Un'app di retrieval che ha bisogno di embedding deve ottenerli altrove.
  • Non il modello di punta di un fornitore. Se hai bisogno di un modello specifico con nome per conformità o benchmark, usa quel fornitore.
  • Limite rigido. Nessun contenuto sessuale che coinvolga minorenni, mai.

Molti team eseguono due endpoint: un provider principale e un secondo per i contenuti che il primo rifiuta. Poiché entrambi condividono lo stesso formato, è una piccola quantità di codice, un cambio di configurazione e un fallback su certi errori.

Costi: come confrontare

Controlla la tariffazione attuale di ogni fornitore e convertila nella forma della tua richiesta. Per questo endpoint, i costi di input sono $0,15 per 1M di token e quelli di output $0,50 per 1M. Esempio: 3.000 token di input e 500 di output costano $0,00045 + $0,00025 = $0,0007 per chiamata, quindi 10.000 chiamate al mese costano $7. Le richieste fallite o rifiutate non vengono addebitate, non c'è abbonamento e il credito non scade mai.

Le ricariche vanno da $20 a $500, con cripto (USDT su TRC20, USDC su Base), con un bonus del +5% da $50, +10% da $100 e +15% da $200. Per una tabella di come si confrontano le diverse scelte di modello, vedi confronto tra modelli AI e prezzi. La pagina dei prezzi ha l'elenco completo.

Un pattern di fallback per due endpoint

Se vuoi un secondo endpoint per i contenuti che il tuo provider principale rifiuta, mantieni entrambi i client e scegli in base alla richiesta. Questo sketch invia una richiesta al provider principale per primo e prova il secondo quando la risposta è un marcatore di rifiuto che definisci, o quando una chiamata fallisce:

import os
from openai import OpenAI

main = OpenAI(api_key=os.environ["MAIN_KEY"])
second = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",
    api_key=os.environ["NEW_PROVIDER_KEY"],
)

def ask(messages, main_model, use_second_first=False):
    order = [(second, "uncensored"), (main, main_model)] if use_second_first else [(main, main_model), (second, "uncensored")]
    last = None
    for client, model in order:
        try:
            r = client.chat.completions.create(model=model, messages=messages)
            return r.choices[0].message.content
        except Exception as err:
            last = err
    raise last

Instrada in base al tipo di contenuto dove possibile. Una funzionalità di scrittura di storie può andare direttamente al secondo endpoint con use_second_first=True, mentre un assistente di fatturazione rimane su quello principale. Questo evita di pagare per una chiamata fallita per prima cosa e mantiene il comportamento prevedibile per gli utenti.

Un modo sicuro per testare

Non spostare tutto il traffico in una volta. Richiedi il trial da $0,50 nella pagina delle chiavi API, che non richiede carta e dura 7 giorni, poi esegui questi passaggi:

  1. Rigioca 20 prompt reali dai tuoi log contro il nuovo endpoint.
  2. Confronta risposte, conteggi di token e fallimenti con il tuo provider attuale.
  3. Forza un 429 e conferma che il tuo retry funziona.
  4. Invia il 5% del traffico di produzione attraverso un flag di funzionalità.
  5. Osserva l'intestazione X-Balance-USD e il tuo tasso di errore per alcuni giorni prima di ampliare.

La documentazione copre i metodi, e LLM di codifica senza censura mostra un caso d'uso degli sviluppatori in dettaglio.

01

Domande e risposte

Posso usare l'SDK OpenAI con un altro provider?

Sì, se il provider è compatibile con OpenAI. Imposta l'URL di base, la chiave e il nome del modello con i valori del nuovo provider.

Questo servizio è l'API di OpenAI?

No. È un endpoint indipendente compatibile con OpenAI che esegue un modello a pesi aperti e non è un'API ufficiale di OpenAI o di altri fornitori.

Supporta lo streaming e gli strumenti?

Sì. Lo streaming funziona tramite SSE con stream: true e la chiamata di funzioni utilizza il formato standard tools e tool_calls.

Cosa devo verificare prima di cambiare?

Nomi dei modelli, parametri supportati, comportamento nella chiamata di funzioni, limiti di contesto, gestione degli errori 429 e, soprattutto, come il modello risponde ai tuoi prompt reali.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Ottieni la chiave API