Une seule API : Guide de démarrage
Intégrez notre API LLM sans censure avec un seul changement de configuration. La compatibilité prêt à l'emploi signifie que vous remplacez l'URL de base et la clé API, puis conservez votre code existant.
URL de base et authentification
Commencez par pointer votre client vers notre endpoint dédié. Cette api compatible openai utilise des en-têtes d'authentification standards, vous n'avez qu'à modifier deux valeurs dans votre configuration.
L'URL de base est https://api.onekeyllmapi.com/v1. Générez votre clé API unique sur la page d'inscription. Aucune carte n'est requise pour démarrer, et la clé est affichée immédiatement après l'inscription. Conservez cette clé en sécurité ; elle authentifie toutes les requêtes vers le service.
Complétion de base
Envoyez un prompt textuel simple pour recevoir une réponse directe. Il s’agit du cœur de notre offre API IA pour les développeurs. Le modèle renvoie du texte sans refus de contenu pour un usage adulte légal, ce qui le rend idéal pour des tâches créatives ou sans restrictions.
- ID du modèle :
uncensored - Endpoint :
POST /v1/chat/completions - Contexte : 100 000 tokens
Effectuez votre première requête avec cet exemple :
curl https://api.onekeyllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Intégration SDK Python
Utilisez la bibliothèque Python officielle OpenAI pour interagir avec notre service. Les seuls changements nécessaires sont base_url et api_key. Cela garantit que votre logique existante fonctionne sans modification.
- Installez via
pip install openai - Définissez les variables d'environnement ou passez-les directement dans l'initialisation du client
- Appelez
chat.completions.create()comme d'habitude
Configurez le client comme ceci :
from openai import OpenAI
client = OpenAI(base_url="https://api.onekeyllmapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Utilisation SDK Node.js
Intégrez avec des projets JavaScript ou TypeScript en utilisant le package Node OpenAI standard. Pointez le client vers notre URL et fournissez votre clé. Cette approche maintient la compatibilité avec toute structure de client compatible OpenAI.
- Installez via
npm install openai - Initialisez avec une URL de base personnalisée
- Utilisez les modèles standard async/await
Exemple d'initialisation :
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.onekeyllmapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Réponses en streaming
Recevez les réponses token par token pour réduire la latence perçue. Notre api de streaming prend en charge les Server-Sent Events (SSE), vous permettant d’afficher la sortie au fur et à mesure de sa génération. Utile pour les interfaces de chat ou les applications en temps réel.
- Définissez
stream: truedans votre requête - Analysez le flux SSE côté client
- Gérez efficacement les tokens partiels
Activez le streaming dans votre code :
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Limites, erreurs et contexte
Comprenez les contraintes pour créer des intégrations robustes. L’API prend en charge une fenêtre de contexte de 100 000 tokens, permettant de traiter de longs documents ou des conversations. Les requêtes sont limitées à un corps de 8 Mo.
Les erreurs courantes incluent 401 pour les clés invalides, 402 lorsque le crédit prépayé est épuisé, et 429 pour avoir dépassé 300 requêtes par minute. Le crédit de paiement à l'usage n'expire jamais, et vous pouvez recharger à partir de 10 $. L'appel de fonctions est pris en charge pour l'exécution des fonctions.
Fiche technique de l'API
Toutes les limites et fonctions réelles de l'API au même endroit — vérifiez-les avant de recharger.
| Élément | Valeur |
|---|---|
| Format | compatible OpenAI : tout SDK OpenAI fonctionne en changeant la base URL et la clé |
| ID du modèle | uncensored |
| Base URL | https://api.onekeyllmapi.com/v1 |
| Authentification | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Fenêtre de contexte | 100 000 tokens (entrée + sortie) |
| Appel de fonctions | oui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool |
| Mode JSON | response_format: {"type": "json_object"} |
| Paramètres | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | oui — server-sent events ; le dernier bloc contient l'usage des tokens |
| Sortie max. | jusqu'au reste de la fenêtre de 100 000 tokens ; max_tokens optionnel (pas de plafond distinct) |
| Taille | jusqu'à 8 Mo par requête |
| En-têtes | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Limite de débit | 300 requêtes par minute et par clé |
| Concurrence | 8 requêtes simultanées par clé |
| Recharge | USDT (TRC20) ou USDC (Base), tout montant entier de 10 $ à 500 $ |
| Facturation | crédit prépayé selon l'usage réel ; erreurs et refus gratuits |
| Validité | le crédit payé n'expire jamais, sans abonnement |
| Bonus | +5 % dès 50 $, +10 % dès 100 $ |
| Prix | 0,25 $ par million de tokens en entrée · 1,00 $ par million en sortie |
| Essai gratuit | 0,50 $ pendant 7 jours, sans carte · Clé d'essai : 2 requêtes parallèles, 60 par minute ; limites complètes (8 et 300) après la 1re recharge |
| Clés | une clé active par compte ; une nouvelle remplace l'ancienne |
| Connexion | Google ou e-mail et mot de passe |
| Contenu | contenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé |
Erreurs et solutions
Les erreurs arrivent en JSON avec un type stable ; les requêtes échouées ou refusées ne sont pas facturées.
| Code | Type | Signification |
|---|---|---|
400 | bad_request | JSON invalide, messages vides, mauvais paramètre ou contexte trop long |
401 | missing_key · invalid_key · key_revoked | clé absente, erronée ou remplacée |
402 | no_credit | plus de crédit — rechargez, la reprise est immédiate |
403 | content_blocked | contenu sexuel impliquant des mineurs — refusé, non facturé |
404 | not_found | endpoint inconnu |
413 | request_too_large | corps supérieur à 8 Mo |
429 | rate_limited · concurrency | au-delà de 300/min ou 8 en parallèle — patientez |
503 | upstream_busy | modèle occupé — réessayez dans quelques secondes |
Questions et réponses
S'agit-il d'un modèle OpenAI ?
Non. Nous servons un seul modèle de langage large dédié et sans censure, exécuté sur nos propres serveurs GPU. Ce n'est pas GPT, Claude ou le modèle d'un autre fournisseur, mais il est compatible avec leur structure d'API.
Comment fonctionne la tarification ?
Nous utilisons un modèle de paiement à l'usage sans frais mensuels. Les tokens d'entrée coûtent 0,25 $ par 1M, et les tokens de sortie coûtent 1,00 $ par 1M. Le crédit prépayé n'expire jamais, et vous pouvez commencer avec un crédit d'essai de 0,50 $.
Quelle est la taille de la fenêtre de contexte ?
L'API prend en charge une fenêtre de contexte de 100 000 tokens pour le prompt et la complétion. Cela permet des conversations extensives ou le traitement de longs documents dans une seule requête.
Votre clé est à un formulaire de vous
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.