FR ▾

Chinese LLM APITraduction

Obtenir une clé API

Mis à jour le

URL de l'API compatible OpenAI : URL de base et en-têtes

L'URL de base est https://api.chinesellmapi.com/v1. Placez-la là où votre client OpenAI attend une URL de base, ajoutez votre clé en tant que jeton Bearer, et utilisez l'ID de modèle uncensored.

Un câble reliant un terminal d'ordinateur portable à un cube de serveur lumineux, représentant la connexion d'un client à un endpoint d'API

La réponse courte

Si vous recherchez une URL de l'API compatible OpenAI pour ce service, copiez cette valeur :

https://api.chinesellmapi.com/v1

C'est l'URL de base. Chaque SDK OpenAI, client de bureau et framework d'agent qui possède un champ appelé « base URL », « API base », « endpoint » ou « host » prend cette chaîne. La clé va dans le champ « API key » correspondant, et le nom du modèle est uncensored.

Deux endpoints existent derrière : POST /v1/chat/completions pour le chat et GET /v1/models pour lister les modèles. Rien d'autre de l'API OpenAI n'est proposé, donc pas de route embeddings, pas de route images et pas de route fine-tuning. Si vous avez besoin d'une clé d'abord, la page clé API vous guide pour l'inscription.

URL de base versus URL d'endpoint complet

La plupart des erreurs se produisent ici. Les clients se divisent en deux groupes : ceux qui veulent l'URL de base et ajoutent le chemin eux-mêmes, et ceux qui veulent l'URL complète de l'appel. Le tableau montre les deux formes.

Ce que le champ demandeValeur à saisir
URL de base, API base, hôte OpenAIhttps://api.chinesellmapi.com/v1
URL complète des complétions de chathttps://api.chinesellmapi.com/v1/chat/completions
URL de la liste des modèleshttps://api.chinesellmapi.com/v1/models

Les SDK officiels OpenAI, le wrapper OpenAI de LangChain, LiteLLM et la plupart des interfaces de chat appartiennent au premier groupe. Les outils qui vous permettent de coller une URL de requête brute appartiennent au deuxième. Lorsqu'une étiquette de champ ne précise pas de quel type il s'agit, lisez le texte du placeholder : s'il affiche quelque chose se terminant par /v1, il attend l'URL de base.

Barres obliques finales

La plupart des SDK gèrent une barre oblique finale, mais certains construisent le chemin final par simple concaténation de chaînes. Si vous obtenez une erreur 404 et que l'URL se termine par /v1/, supprimez la dernière barre oblique et réessayez.

En-têtes attendus par l'API

Les requêtes nécessitent un en-tête pour l'authentification et un pour le type de corps :

  • Authorization: Bearer YOUR_KEY
  • Content-Type: application/json

Les SDK définissent les deux pour vous. Si vous construisez des requêtes à la main, voici l'appel fonctionnel minimal :

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 réponse contient quelques en-têtes intéressants à journaliser : X-Request-Id pour les questions de support, X-Balance-USD pour le crédit restant, et X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency pour les limites applicables à votre clé.

Définir dans les SDK OpenAI

Seules deux valeurs changent par rapport à une configuration OpenAI standard : l'URL de base et la clé. Tout le reste dans votre code reste tel quel.

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);

Le streaming fonctionne de la même manière : ajoutez stream: true et lisez les fragments. Les données d'utilisation arrivent à la fin du flux. Gardez à l'esprit qu'une requête en streaming occupe l'un de vos slots de concurrence jusqu'à la fermeture du flux.

Variables d'environnement au lieu de code

Les SDK OpenAI actuels pour Python et Node lisent OPENAI_BASE_URL et OPENAI_API_KEY depuis l'environnement lorsque vous ne les passez pas dans le code. C'est le moyen le plus rapide de pointer un projet existant vers un nouvel endpoint sans modifier une seule ligne :

export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py

De nombreux outils tiers utilisent les mêmes deux noms de variable, bien que certains utilisent les leurs, comme API_BASE ou OPENAI_API_BASE dans les projets plus anciens. Consultez la documentation de l'outil pour le nom exact. Si un projet code en dur api.openai.com quelque part, recherchez ce nom d'hôte dans le code source et remplacez-le.

Le nom du modèle se trouve généralement dans un paramètre séparé, alors n'oubliez pas de le changer en uncensored aussi. Laisser un nom de modèle OpenAI par défaut en place est la deuxième raison la plus courante d'erreur après une URL incorrecte.

Vérifiez la connexion avant de déboguer votre application

Testez l'URL et la clé avec un appel qui ne coûte rien. Lister les modèles ne nécessite pas de tokens :

curl https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Si cela renvoie une liste JSON incluant uncensored, l'URL et la clé sont correctes et tout problème restant se trouve dans les paramètres de votre client. Si cela échoue, utilisez ce tableau.

SymptômeCause probableCorrection
404 Non trouvéChemin doublé (/v1/v1/...) ou /v1 manquantSaisissez l'URL de base exactement une fois, se terminant par /v1
401 Non autoriséClé manquante, copiée avec un espace, ou envoyée dans le mauvais en-têteEnvoyez Authorization: Bearer YOUR_KEY et recopiez la clé
429 avec le code rate_limitedTrop de requêtes par minuteRalentissez ou mettez en file d'attente les requêtes
429 avec le code concurrencyTrop de requêtes au même momentLimitez les appels parallèles, rappelez-vous que les streams occupent un slot
429 avec Retry-After: 5Surcharge temporaireAttendez cinq secondes et réessayez
Modèle non trouvéUn nom de modèle OpenAI laissé en placeDéfinissez le modèle sur uncensored

Limites à connaître avant de pointer la production dessus

Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. La clé d'essai permet 2 requêtes simultanées et 60 par minute. Le corps de la requête peut faire jusqu'à 8 Mo, et la fenêtre de contexte est de 100 000 tokens, prompt et complétion confondus, donc max_tokens est optionnel.

Le service est textuel uniquement et exécute un seul modèle à poids ouverts d'un fournisseur indépendant. Ce n'est l'API officielle d'aucun fournisseur de modèles et il ne fait pas de routage entre les fournisseurs. Si votre application est un produit en langue chinoise, le guide de démarrage rapide de l'application en langue chinoise montre comment structurer les prompts, et le guide de l'API de traduction couvre les glossaires et les placeholders.

La facturation est en paiement à l'usage à partir de crédit prépayé : 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie. Les requêtes échouées ou refusées ne sont pas facturées. La page tarification liste les montants de rechargement et les bonus, et les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai gratuit en un clic sur la page clé, valable 7 jours et sans carte. Pour un guide plus détaillé de la configuration client, consultez les docs de démarrage rapide.

Le contenu sexualisant les mineurs est toujours interdit ; à part cela, le modèle est ajusté pour répondre sans refus de contenu pour une utilisation adulte légale.

Autres endroits où l'URL est utilisée

Les frameworks nomment le champ différemment, mais la valeur est identique. Voici trois exemples courants :

# 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"}],
)

Dans LiteLLM, le préfixe openai/ indique à la bibliothèque d'utiliser le format filaire OpenAI contre votre propre URL de base, et la partie après la barre oblique est l'ID du modèle. Les interfaces de chat telles que SillyTavern disposent d'une source « compatible OpenAI personnalisée » avec trois champs : URL, clé et modèle. Encore trois valeurs identiques.

Gardez la clé hors du navigateur

N'appelez pas l'API depuis du JavaScript côté client livré aux visiteurs. N'importe qui peut lire la clé depuis la page et dépenser votre crédit. Insérez un petit point de terminaison de serveur entre les deux, stockez la clé dans une variable d'environnement à cet endroit, et laissez votre site appeler ce point de terminaison.

Passer d'un endpoint à un autre sans modifier le code

Si vous testez plusieurs fournisseurs, placez les trois valeurs dans la configuration plutôt que dans le code source. Un petit bloc de paramètres suffit et rend l'URL le seul élément à modifier :

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")

Cela facilite également la séparation entre les environnements de test et de production : utilisez une clé différente par environnement, et l'en-tête de réponse X-Balance-USD affichera le crédit restant de chacun.

Questions et réponses

Dois-je inclure /chat/completions dans l'URL de base ?

Non. Entrez https://api.chinesellmapi.com/v1 et laissez le SDK ajouter /chat/completions. Seuls les outils qui demandent une URL de requête complète nécessitent la forme longue.

Puis-je utiliser la même URL pour plusieurs applications ?

Oui. L'URL et la clé peuvent être utilisées dans autant de clients que nécessaire. Elles partagent les limites de votre clé : 8 requêtes simultanées et 300 requêtes par minute pour une clé complète.

Quel nom de modèle dois-je entrer ?

Utilisez uncensored. Vous pouvez le confirmer en appelant GET /v1/models avec votre clé.

S'agit-il de l'API officielle d'un fournisseur de style OpenAI ?

Non. Il s'agit d'une API hébergée pour un seul modèle à poids ouverts, gérée par un fournisseur indépendant, conçue pour être compatible avec le format de requête OpenAI.

Comment tester la clé sans dépenser de crédit ?

Appelez GET /v1/models avec l'en-tête Authorization. Cela retourne la liste des modèles et n'utilise pas de tokens.

Votre clé n'est qu'à un formulaire de distance

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API