Prompts et scripts via un seul endpoint
Obtenez votre clé API textuelle sans censure et commencez à envoyer des requêtes au pipeline textuel stableaudio en quelques minutes. Utilisez l'endpoint compatible OpenAI pour l'ingénierie de prompts, la génération de légendes ou le post-traitement avec une facturation prépayée prévisible.
URL de base et authentification
Utilisez l'URL de base https://api.stableaudio.top/v1 avec n'importe quel client compatible OpenAI. Transmettez votre clé API dans l'en-tête Authorization en tant que Bearer YOUR_API_KEY. Vous pouvez générer une clé instantanément sur la page Obtenir la clé API en utilisant Google ou e-mail + mot de passe. Chaque compte prend en charge une clé active ; l'émission d'une nouvelle clé remplace la clé précédente. L'endpoint prend en charge uniquement POST /v1/chat/completions et GET /v1/models. Aucune génération d'embeddings, d'images, d'audio ou de vidéo n'est disponible ici. Il s'agit d'une couche textuelle uniquement pour votre pipeline audio.
Envoyer votre première requête
Envoyez une requête de complétion de chat standard pour générer du texte. L'ID du modèle est uncensored. Il s'agit d'un modèle à poids ouverts réglé pour réduire les refus de contenu sur les sujets adultes licites. Vous pouvez ajuster des paramètres tels que temperature et top_p. Le modèle dispose d'une fenêtre de contexte de 100 000 tokens. Vous pouvez demander jusqu'à 32 000 tokens par réponse. La tarification est transparente : 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie. Les erreurs et les refus ne consomment pas de crédit.
curl https://api.stableaudio.top/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 le SDK Python officiel d'OpenAI pour intégrer l'API dans vos scripts Python. Définissez le base_url et le api_key dans la configuration de votre client. Cela vous permet de tirer parti des bases de code existantes qui utilisent déjà l'interface d'OpenAI. Le client gère automatiquement la sérialisation JSON et l'analyse des réponses. Vous pouvez diffuser des réponses ou les traiter en mode lot. Cette approche fonctionne pour la génération de prompts, l'écriture de scripts ou l'extraction de données structurées à partir d'entrées textuelles pour votre flux de travail audio.
from openai import OpenAI
client = OpenAI(base_url="https://api.stableaudio.top/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)
Intégration SDK Node.js
Intégrez l'API dans vos applications Node.js à l'aide du SDK Node d'OpenAI. Configurez le client avec l'URL de base et la clé API correctes. Cela garantit la compatibilité avec les modèles standard d'OpenAI. Vous pouvez effectuer des requêtes synchrones ou asynchrones. Utilisez ceci pour le traitement textuel en temps réel dans les webhooks ou les tâches en arrière-plan. Le SDK gère la logique de nouvelle tentative et l'analyse des réponses. C'est idéal pour créer des scripts de voix off ou des pipelines de légendes qui nécessitent une sortie textuelle fiable et sans censure sans frais d'abonnement.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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 (SSE)
Activez le streaming en définissant stream: true dans votre requête. L'API retourne des événements envoyés par le serveur (SSE). Les informations d'utilisation des tokens sont incluses dans le dernier chunk. Cela réduit la latence perçue pour la génération de texte long. Utilisez ceci pour la légende en direct ou l'affinement interactif des prompts. L'ID du modèle reste uncensored. Le streaming ne modifie pas le modèle de tarification. Vous ne payez toujours que pour les tokens réels générés. Les erreurs lors du streaming sont gérées de manière transparente sans consommer de crédit supplémentaire.
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 et quotas de tokens
Le modèle prend en charge une fenêtre de contexte de 100 000 tokens. La sortie maximale est de 32 000 tokens par requête, ou 2 048 si max_tokens n'est pas défini. Vous êtes limité à 300 requêtes par minute par clé. La concurrence est limitée à 8 requêtes simultanées par clé. Les corps de requête ne doivent pas dépasser 8 Mo. Si vous dépassez la limite de débit, vous recevez une erreur 429. Si votre clé est invalide, vous recevez une erreur 401. Si vous disposez de crédit prépayé insuffisant, vous recevez une erreur 402. Les erreurs et les refus sont gratuits. Le crédit n'expire jamais. Rechargez par carte (Visa, Mastercard, Apple Pay, Google Pay) ou crypto (USDT sur TRC20, USDC sur Base) de 20 $ à 500 $.
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 |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Authentification | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.stableaudio.top/v1 |
| Paramètres | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Mode JSON | response_format: {"type": "json_object"} |
| Sortie max. | jusqu'au reste de la fenêtre de 100 000 tokens ; max_tokens optionnel (pas de plafond distinct) |
| Streaming | oui — server-sent events ; le dernier bloc contient l'usage des tokens |
| Appel de fonctions | oui — tools, tool_choice ; réponse avec tool_calls, aussi en streaming ; résultats en role: tool |
| Fenêtre de contexte | 100 000 tokens (entrée + sortie) |
| Limite de débit | 300 requêtes par minute et par clé |
| En-têtes | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Taille | jusqu'à 8 Mo par requête |
| Concurrence | 8 requêtes simultanées par clé |
| Facturation | crédit prépayé selon l'usage réel ; erreurs et refus gratuits |
| Prix | 0,15 $ par million de tokens en entrée · 0,50 $ par million en sortie |
| Bonus | +5 % dès 50 $, +10 % dès 100 $, +15 % dès 200 $ |
| 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 |
| Recharge | USDT (TRC20) ou USDC (Base), tout montant entier de 20 $ à 500 $ |
| Validité | le crédit payé n'expire jamais, sans abonnement |
| Contenu | contenu adulte autorisé ; tout contenu sexuel impliquant des mineurs est refusé |
| Clés | une clé active par compte ; une nouvelle remplace l'ancienne |
| Connexion | Google ou e-mail et mot de passe |
Codes d'erreur
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
Que signifie « sans censure » pour cette API ?
Le modèle n'accepte pas les sujets adultes licites, fictifs, liés à la recherche en sécurité ou controversés. Il est réglé pour répondre sans refus de contenu. La seule limite stricte est que le contenu sexuel impliquant des mineurs est toujours bloqué.
Comment la facturation est-elle gérée et quand les erreurs sont-elles gratuites ?
Vous ne payez que pour l'utilisation réelle des tokens. Les erreurs et les refus ne consomment pas votre crédit prépayé. Le crédit est rechargé par carte (Visa, Mastercard, Apple Pay, Google Pay) ou crypto (USDT sur TRC20, USDC sur Base) et n'expire jamais. Vous pouvez recharger de 20 $ à 500 $.
Puis-je l'utiliser pour la génération d'images ou d'audio ?
Non. Il s'agit d'une API de chat-completions textuelle uniquement. Elle alimente la couche textuelle de votre pipeline audio, comme la rédaction de prompts ou la génération de légendes. Elle ne génère pas d'images, d'audio ou de vidéo elle-même.
Votre clé est à un formulaire de vous
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.