IT ▾

Chinese LLM APITraduzione

Ottieni la chiave API

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.

Un cavo che collega il terminale di un laptop a un cubo di server luminoso, che rappresenta la connessione di un client a un endpoint API

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 campoValore da inserire
URL base, API base, host OpenAIhttps://api.chinesellmapi.com/v1
URL completo per le chat completionshttps://api.chinesellmapi.com/v1/chat/completions
URL elenco modellihttps://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_KEY
  • Content-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.

SintomoCausa probabileSoluzione
404 Non trovatoPercorso duplicato (/v1/v1/...) o /v1 mancanteInserisci l'URL base esattamente una volta, terminante con /v1
401 Non autorizzatoChiave mancante, copiata con uno spazio o inviata nell'intestazione sbagliataInvia Authorization: Bearer YOUR_KEY e ricopia la chiave
429 con codice rate_limitedTroppe richieste al minutoRallenta o accoda le richieste
429 con codice concurrencyTroppe richieste nello stesso momentoLimita le chiamate parallele, ricorda che gli stream occupano uno slot
429 con Retry-After: 5Sovraccarico temporaneoAttendi cinque secondi e riprova
Modello non trovatoUn nome di modello OpenAI residuoImposta 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.

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.

Ottieni la chiave API