Aggiornato
URL API compatibile con OpenAI: URL base e intestazioni
L'URL base è https://api.chinesellmapi.com/v1. Inseriscilo dove il tuo client OpenAI si aspetta un URL base, aggiungi la tua chiave come token Bearer e usa l'ID del modello uncensored.

La risposta breve
Se stai cercando un URL API compatibile con OpenAI per questo servizio, copia questo valore:
https://api.chinesellmapi.com/v1
Quello è l'URL base. Ogni SDK OpenAI, client desktop e framework di agenti che ha un campo chiamato "base URL", "API base", "endpoint" o "host" accetta questa stringa. La chiave va inserita nel campo "API key" corrispondente e il nome del modello è uncensored.
Ci sono due endpoint dietro di essa: POST /v1/chat/completions per la chat e GET /v1/models per elencare i modelli. Non viene offerto nient'altro dall'interfaccia OpenAI, quindi non ci sono endpoint per gli embedding, per le immagini e per il fine-tuning. Se ti serve prima una chiave, la pagina delle chiavi API ti guida alla registrazione.
URL base rispetto a URL endpoint completo
La maggior parte degli errori avviene qui. I client si dividono in due gruppi: quelli che vogliono l'URL base e aggiungono il percorso da soli, e quelli che vogliono l'URL completo della chiamata. La tabella mostra entrambe le forme.
| Cosa richiede il campo | Valore da inserire |
|---|---|
| URL base, API base, host OpenAI | https://api.chinesellmapi.com/v1 |
| URL completo per le chat completions | https://api.chinesellmapi.com/v1/chat/completions |
| URL elenco modelli | https://api.chinesellmapi.com/v1/models |
Gli SDK ufficiali OpenAI, il wrapper OpenAI di LangChain, LiteLLM e la maggior parte delle interfacce chat appartengono al primo gruppo. Gli strumenti che ti permettono di incollare un URL di richiesta grezza appartengono al secondo. Quando l'etichetta di un campo non specifica quale dei due è, leggi il testo segnaposto: se mostra qualcosa che termina con /v1, vuole l'URL base.
Barre finali
La maggior parte degli SDK gestisce una barra finale, ma alcuni costruiscono il percorso finale unendo semplicemente le stringhe. Se ottieni un 404 e l'URL termina con /v1/, rimuovi l'ultima barra e riprova.
Intestazioni che l'API si aspetta
Le richieste richiedono un'intestazione per l'autenticazione e una per il tipo di corpo:
Authorization: Bearer YOUR_KEYContent-Type: application/json
Gli SDK le impostano entrambe per te. Se costruisci le richieste manualmente, ecco la chiamata funzionante più semplice:
curl https://api.chinesellmapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one sentence."}]
}'
La risposta contiene alcune intestazioni che vale la pena registrare: X-Request-Id per le domande di supporto, X-Balance-USD per il credito residuo, e X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency per i limiti applicabili alla tua chiave.
Impostazione negli SDK OpenAI
Solo due valori cambiano rispetto a una configurazione OpenAI standard: l'URL base e la chiave. Tutto il resto nel tuo codice rimane così com'è.
Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)
Node
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.chinesellmapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);
Lo streaming funziona allo stesso modo: aggiungi stream: true e leggi i chunk. Le cifre di utilizzo arrivano alla fine dello stream. Tieni presente che una richiesta in streaming occupa uno dei tuoi slot di concorrenza fino alla chiusura dello stream.
Variabili d'ambiente invece che codice
Gli SDK OpenAI attuali per Python e Node leggono OPENAI_BASE_URL e OPENAI_API_KEY dall'ambiente quando non li passi nel codice. Questo è il modo più veloce per puntare un progetto esistente a un nuovo endpoint senza toccare una riga:
export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py
Molti strumenti di terze parti usano gli stessi due nomi di variabile, anche se alcuni usano i propri, come API_BASE o OPENAI_API_BASE nei progetti più vecchi. Controlla la documentazione dello strumento per il nome esatto. Se un progetto fissa api.openai.com da qualche parte, cerca il nome di host nel codice sorgente e sostituiscilo.
Il nome del modello si trova solitamente in un'impostazione separata, quindi ricorda di cambiarlo anche in uncensored. Lasciare un nome di modello OpenAI predefinito è la seconda causa più comune di errore dopo un URL errato.
Controlla la connessione prima di eseguire il debug della tua app
Testa l'URL e la chiave con una chiamata che non costa nulla. L'elenco dei modelli non richiede token:
curl https://api.chinesellmapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Se questo restituisce un elenco JSON che include uncensored, l'URL e la chiave sono corretti e qualsiasi problema rimanente risiede nelle impostazioni del tuo client. Se fallisce, usa questa tabella.
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| 404 Non trovato | Percorso duplicato (/v1/v1/...) o /v1 mancante | Inserisci l'URL base esattamente una volta, terminante con /v1 |
| 401 Non autorizzato | Chiave mancante, copiata con uno spazio o inviata nell'intestazione sbagliata | Invia Authorization: Bearer YOUR_KEY e ricopia la chiave |
429 con codice rate_limited | Troppe richieste al minuto | Rallenta o accoda le richieste |
429 con codice concurrency | Troppe richieste nello stesso momento | Limita le chiamate parallele, ricorda che gli stream occupano uno slot |
429 con Retry-After: 5 | Sovraccarico temporaneo | Attendi cinque secondi e riprova |
| Modello non trovato | Un nome di modello OpenAI residuo | Imposta il modello su uncensored |
Limiti che dovresti conoscere prima di puntare la produzione ad esso
Una chiave completa permette 8 richieste parallele e 300 richieste al minuto. La chiave di prova permette 2 richieste parallele e 60 al minuto. Il corpo della richiesta può essere fino a 8 MB, e la finestra di contesto è di 100.000 token, prompt e completamento insieme, quindi max_tokens è facoltativo.
Il servizio è solo testo ed esegue un singolo modello a pesi aperti da un provider indipendente. Non è l'API ufficiale di alcun fornitore di modelli e non instrada il traffico tra i fornitori. Se la tua app è un prodotto in lingua cinese, la guida rapida per le app in lingua cinese mostra come strutturare i prompt, e la guida all'API di traduzione copre glossari e segnaposto.
La fatturazione è a consumo da credito prepagato: $0,15 per 1M di token di input e $0,50 per 1M di token di output. Le richieste fallite o rifiutate non vengono addebitate. La pagina dei prezzi elenca le dimensioni delle ricariche e i bonus, e i nuovi utenti possono richiedere $0,50 di credito di prova con un clic sulla pagina delle chiavi, valido per 7 giorni e senza carta. Per una guida più lunga alla configurazione del client, consulta la documentazione quickstart.
I contenuti che sessualizzano i minorenni non sono mai consentiti; a parte questo, il modello è ottimizzato per rispondere senza rifiuti sui contenuti per l'uso adulto legale.
Altri luoghi dove va l'URL
I framework chiamano il campo in modo diverso, ma il valore è lo stesso. Tre esempi comuni:
# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
model="uncensored",
)
# LiteLLM
import litellm
r = litellm.completion(
model="openai/uncensored",
api_base="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
messages=[{"role": "user", "content": "ping"}],
)
In LiteLLM il prefisso openai/ dice alla libreria di utilizzare il formato wire di OpenAI contro il tuo URL base, e la parte dopo la barra è l'ID del modello. Le interfacce chat come SillyTavern hanno una sorgente "compatibile OpenAI personalizzata" con tre caselle: URL, chiave e modello. Di nuovo gli stessi tre valori.
Tieni la chiave fuori dal browser
Non chiamare l'API dal JavaScript front-end che viene distribuito ai visitatori. Chiunque può leggere la chiave dalla pagina e spendere il tuo credito. Metti un piccolo endpoint del server in mezzo, memorizza la chiave in una variabile d'ambiente lì, e lascia che il tuo sito chiami quell'endpoint.
Passare tra gli endpoint senza modifiche al codice
Se testi diversi provider, metti i tre valori nella configurazione piuttosto che nel codice sorgente. Un piccolo blocco di impostazioni fa il lavoro e rende l'URL l'unica cosa che modifichi:
import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")
Questo rende anche facile separare staging e produzione: usa una chiave diversa per ogni ambiente, e l'intestazione di risposta X-Balance-USD mostrerà il credito residuo di ciascuno.
Altre guide
Domande e risposte
Includo /chat/completions nell'URL base?
No. Inserisci https://api.chinesellmapi.com/v1 e lascia che l'SDK aggiunga /chat/completions. Solo gli strumenti che richiedono un URL di richiesta completo hanno bisogno della forma più lunga.
Posso usare lo stesso URL per diverse app?
Sì. L'URL e la chiave possono andare in qualsiasi numero di client. Condividono i limiti della tua chiave: 8 richieste parallele e 300 richieste al minuto su una chiave completa.
Quale nome di modello inserisco?
Usa uncensored. Puoi confermarlo chiamando GET /v1/models con la tua chiave.
È questa l'API ufficiale di un fornitore in stile OpenAI?
No. È un'API ospitata per un modello a pesi aperti gestita da un provider indipendente, costruita per essere compatibile con il formato di richiesta OpenAI.
Come faccio a testare la chiave senza spendere credito?
Chiama GET /v1/models con l'intestazione Authorization. Restituisce l'elenco dei modelli e non usa token.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.