Clé API compatible OpenAI : Obtenez-en une et envoyez une requête
Une clé API compatible OpenAI est un jeton bearer standard qui fonctionne avec n'importe quel SDK OpenAI une fois que vous avez pointé le client vers une URL de base différente. Cette page montre comment en obtenir une pour l'API textuelle hébergée sur ce site et effectuer une requête fonctionnelle en quelques minutes.
Mis à jourSpeech To Text API

Ce qu'est réellement la clé
"Compatible OpenAI" décrit la forme de l'API HTTP, pas l'entreprise derrière celle-ci. Le service accepte le même corps JSON sur POST /v1/chat/completions que les SDK OpenAI envoient, et il lit le même en-tête Authorization: Bearer. Grâce à cela, une clé de ce service s'intègre dans n'importe quel outil qui vous permet de définir une URL de base et une clé API personnalisées : les bibliothèques officielles Python et Node, LangChain, curl brut, et la plupart des clients de chat de bureau.
La clé n'est pas une clé OpenAI, et elle ne fonctionnera pas sur api.openai.com. L'inverse est également vrai : une clé OpenAI ne fonctionnera pas ici. Chaque clé appartient à un service, et celui-ci exécute un seul modèle à poids ouverts, ajusté pour répondre sans refus de contenu pour un usage adulte légal, hébergé par un fournisseur indépendant. Ce n'est pas l'API officielle d'aucun fournisseur de modèle et elle ne redirige pas vers d'autres fournisseurs.
Voici ce dont vous devez vous souvenir. L'URL de base pour ce site est https://api.speechtotextapis.com/v1. L'ID du modèle est uncensored. La clé est la chaîne de caractères que vous obtenez après vous être inscrit. Tout ce qui suit est une variation de ces trois valeurs.
Le service est textuel uniquement. Il gère les complétions de chat, le streaming, l'appel d'outils et le mode JSON. Il ne génère ni images ni audio, ne propose pas d'embeddings et ne permet pas le fine-tuning des modèles. Si vous êtes arrivé ici depuis un pipeline audio, la tâche typique est l'étape de traitement du texte après la transcription : nettoyage d'une transcription, découpage en scènes, réécriture des dialogues ou extraction de données structurées. Le guide de traitement des scripts vocaux couvre ce sujet plus en détail.
Obtenez votre clé en quatre étapes
- Inscrivez-vous. Utilisez Google, ou enregistrez-vous avec une adresse e-mail et un mot de passe.
- Ouvrez la page de la clé API. Elle se trouve à la page de la clé sur ce site. Votre clé est créée et affichée là-bas.
- Réclamez le crédit d'essai. Un bouton sur la même page vous donne 0,50 $ de crédit d'essai en un clic. Il est valable une fois par personne, pendant 7 jours, et ne nécessite pas de carte.
- Copiez la clé dans un magasin de secrets. Une variable d'environnement suffit pour un test local. Pour tout déploiement, utilisez le gestionnaire de secrets de votre hôte.
L'essai est conçu pour prouver que l'intégration fonctionne avant que vous ne payiez quoi que ce soit. Au prix actuel, il suffit pour beaucoup de requêtes courtes, et la section des coûts plus bas montre le calcul. Lorsque vous êtes prêt à continuer, la page de tarification liste les montants de rechargement. Le crédit est prépayé, il n'y a pas d'abonnement, et le crédit n'expire jamais, donc il n'y a aucune pression pour dépenser un rechargement avant une date limite.
Les clés d'essai sont plus limitées que les clés complètes : 2 requêtes simultanées et 60 requêtes par minute. C'est largement suffisant pour un premier script. Si vous prévoyez de répartir en parallèle des dizaines de morceaux de transcription, vous atteindrez probablement la limite jusqu'à ce que vous passiez à un compte financé.
Les trois paramètres demandés par chaque client
Quel que soit le logiciel que vous utilisez, l'écran de configuration demande les mêmes trois choses sous des noms légèrement différents.
| Paramètre | Nom de champ typique | Valeur |
|---|---|---|
| Endpoint | URL de base, base API, hôte | https://api.speechtotextapis.com/v1 |
| Identifiant | Clé API, token, secret | Votre clé de la page de clé |
| Modèle | Modèle, nom du modèle, moteur | uncensored |
Un détail embête les gens : l'URL de base se termine déjà par /v1. Les SDKs ajoutent eux-mêmes /chat/completions, donc vous ne devez pas l'ajouter. Si votre client demande l'URL complète du point de terminaison de chat au lieu d'une URL de base, la valeur est https://api.speechtotextapis.com/v1/chat/completions.
Si un outil ne propose qu'un préréglage "OpenAI" avec un hôte codé en dur et aucun moyen de le modifier, il ne peut pas communiquer avec ce service. Cherchez une option "personnalisé", "compatible OpenAI" ou "avancée" qui expose le champ URL de base.
Votre première requête
Commencez par curl, car il supprime toutes les couches entre vous et l'API. Remplacez YOUR_KEY par la clé que vous avez copiée.
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
Une réponse réussie est un objet JSON avec un choices tableau. Le texte est dans choices[0].message.content, et un bloc usage signale les tokens pour lesquels vous avez été facturé.
Le même appel avec la bibliothèque Python officielle ressemble à ceci. Seuls base_url et api_key diffèrent d'une configuration OpenAI standard.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
Et dans Node, en utilisant le même package :
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
Vous n'avez pas besoin de définir max_tokens. Lorsqu'il est omis, la complétion peut utiliser tout ce qui reste de la fenêtre de 100 000 tokens après votre prompt. Définissez-le vous-même si vous voulez un plafond strict sur le coût par appel.
Vérifiez que la clé fonctionne sans dépenser de tokens
Avant de connecter une clé à un système plus large, faites un appel peu coûteux au point de terminaison des modèles. Il confirme que la clé est acceptée et que l'URL de base est correcte.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Le drapeau -i imprime les en-têtes de réponse, où cette API signale un état utile :
X-Request-Ididentifie la requête. Incluez-le si vous contactez le support au sujet d'un appel spécifique.X-Balance-USDaffiche le crédit restant sur le compte.X-RateLimit-Limit-RequestsetX-RateLimit-Limit-Concurrencyaffichent les limites qui s'appliquent à votre clé, afin que vous puissiez voir d'un coup d'œil si la clé a des limites d'essai ou complètes.
Lire X-Balance-USD dans votre propre code est un moyen peu coûteux de vous alerter avant l'épuisement du crédit. Enregistrez-le une fois par tâche plutôt qu'une fois par requête si vous ne voulez pas de sortie bruyante.
Combien coûte l'utilisation d'une clé
Avoir une clé ne coûte rien. Vous payez pour les tokens : 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie, prélevés sur le crédit prépayé. Les requêtes échouées ou refusées ne sont pas facturées.
Un exemple concret avec l'appel de nettoyage de transcription ci-dessus. Supposons qu'un prompt fasse 1 000 tokens et que la réponse nettoyée fasse 500 tokens.
- Entrée : 1 000 / 1 000 000 x 0,15 $ = 0,00015 $
- Sortie : 500 / 1 000 000 x 0,50 $ = 0,00025 $
- Total : 0,0004 $ par appel
Les 0,50 $ d'essai couvrent donc environ 1 250 appels de cette taille (0,50 $ / 0,0004 $). Vos propres chiffres varieront, car les transcriptions varient en longueur, mais la méthode est la même : comptez les tokens entrants, comptez les tokens sortants, multipliez.
Lorsque vous rechargez, tout montant entier de $20 à $500 est accepté. Les recharges plus importantes comportent un bonus : +5 % à partir de $50, +10 % à partir de $100 et +15 % à partir de $200. Une recharge de $100, par exemple, vous donne $110 de crédit. Vous pouvez payer avec de la crypto (USDT sur TRC20, USDC sur Base).
Garder la clé en sécurité
Une clé API est un mot de passe pour votre solde. Quiconque la possède peut dépenser votre crédit, donc traitez-la comme telle.
- Conservez-la hors du contrôle de version. Lisez-la depuis une variable d’environnement ou un gestionnaire de secrets.
- Ne l’expédiez pas dans le JavaScript côté navigateur ou dans le bundle d’une application mobile. Tout ce qui s’exécute sur l’appareil de l’utilisateur peut être inspecté. Placez un petit serveur entre votre interface et l’API et laissez le serveur ajouter l’en-tête.
- Ne la collez pas dans des captures d’écran, des tickets ou des messages de chat.
- Si vous pensez qu’une clé a fuité, cessez de l’utiliser et contactez le support immédiatement plutôt que d’attendre de voir ce qui se passe.
En matière de confidentialité : les prompts envoyés à l’API ne sont pas utilisés pour l’entraînement. Cela concerne le service, mais ce n’est pas une raison pour envoyer des secrets que vous n’avez pas besoin d’envoyer. Masquez les données personnelles dans les transcriptions lorsque la tâche ne l’exige pas.
En cas d’échec de l’appel
La plupart des problèmes du premier jour proviennent de l’une des quatre causes.
L’URL de base est incorrecte
Les deux erreurs habituelles sont l'oubli de /v1 et la duplication de /chat/completions. Comparez votre valeur caractère par caractère avec celle du tableau ci-dessus.
La clé contient un caractère parasite
La copie depuis une page entraîne souvent un espace ou une nouvelle ligne en fin de chaîne. Nettoyez la valeur dans votre code et vérifiez que l’en-tête est Bearer, suivi d’une espace, puis de la clé.
Le nom du modèle n’est pas uncensored
Les clients basculent souvent sur un autre nom de modèle. Définissez explicitement le modèle à chaque appel.
HTTP 429
Il existe deux variantes, et le code d'erreur les distingue. rate_limited signifie que vous avez envoyé trop de requêtes par minute. concurrency signifie que trop étaient en cours simultanément. Une requête en streaming occupe sa place de concurrence jusqu'à la fin du flux, donc un lecteur lent peut provoquer cette erreur même à un faible taux de requêtes. Un 429 avec un en-tête Retry-After: 5 signifie que le service est brièvement surchargé ; attendez les cinq secondes et réessayez. Un court backoff exponentiel dans votre client gère les trois cas.
Pour la liste complète des paramètres, le format de streaming et les détails de l’appel de fonctions, consultez la documentation de l’API.
Plus de guides
Questions et réponses
S’agit-il de la même clé qu’une clé OpenAI ?
Non. Elle suit le même format de requête, donc les SDK OpenAI fonctionnent avec, mais elle est émise par ce service et fonctionne uniquement contre l’URL de base de ce service.
Ai-je besoin d’une carte bancaire pour obtenir une clé ?
Non. Inscrivez-vous avec Google ou par e-mail, puis réclamez le crédit d’essai de 0,50 $ en un clic sur la page de la clé. L’essai ne nécessite aucune carte et est valable 7 jours.
Quel nom de modèle dois-je utiliser ?
Utilisez uncensored dans le champ modèle. Un appel à GET /v1/models listera ce à quoi la clé peut accéder.
Puis-je utiliser la même clé depuis plusieurs serveurs ?
Oui, mais les limites s'appliquent à la clé dans son ensemble : 8 requêtes concurrentes et 300 requêtes par minute sur une clé standard, 2 et 60 sur une clé d'essai.
La clé fonctionne-t-elle pour les images ou la parole ?
Non. L’API est textuelle uniquement. Elle ne génère ni ne transcrit l’audio ou les images, et elle ne propose ni embeddings ni fine-tuning.
Votre clé est à un formulaire de vous
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.