ObscuraGate API
Accès aux modèles DeepSeek V4 via une API compatible OpenAI. Solde prépayé, rechargeable en stablecoins, facturé au token près.
Vous intégrez avec un assistant IA ? Donnez-lui la version texte : https://api.obscuragate.com/docs/llms.txt
https://api.obscuragate.com/v1Authorization: Bearer sk-…OpenAI Chat CompletionsDémarrage rapide
Tout client compatible OpenAI fonctionne : il suffit de changer l'URL de base et la clé. Votre clé sk-… vous a été remise une seule fois ; conservez-la comme un mot de passe (variable d'environnement, gestionnaire de secrets) et ne l'intégrez jamais dans du code côté navigateur.
pip install openai
from openai import OpenAI
client = OpenAI(
base_url="https://api.obscuragate.com/v1",
api_key="sk-VOTRE_CLE",
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[
{"role": "system", "content": "Tu es un assistant concis."},
{"role": "user", "content": "Explique le cache de prompt en une phrase."},
],
)
print(resp.choices[0].message.content)
print(resp.usage)npm install openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.obscuragate.com/v1",
apiKey: process.env.OBSCURAGATE_API_KEY,
});
const resp = await client.chat.completions.create({
model: "deepseek-v4.1-flash",
messages: [{ role: "user", content: "Bonjour !" }],
});
console.log(resp.choices[0].message.content);curl https://api.obscuragate.com/v1/chat/completions \
-H "Authorization: Bearer $OBSCURAGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{"role": "user", "content": "Bonjour !"}]
}'Modèles et tarifs
Prix en dollars US par million de tokens. Vous ne payez que ce que vous consommez ; il n'y a ni abonnement ni frais fixes.
| Modèle | Entrée | Entrée en cache | Sortie | Usage conseillé |
|---|---|---|---|---|
deepseek-v4.1-flashrecommandé | 0,105 $ | 0,00315 $ | 0,315 $ | Chat, agents, extraction, gros volumes. Le meilleur rapport qualité/prix. |
deepseek-v4-flash | 0,105 $ | 0,00315 $ | 0,315 $ | Génération précédente du modèle rapide. |
deepseek-v4-pro | 0,33 $ | 0,0098 $ | 0,65 $ | Raisonnement difficile, code, tâches longues où la qualité prime. |
deepseek-v4.1-flash-1017deepseek-v4-flash-0731 | 0,105 $ | — | 0,315 $ | Versions datées, figées : comportement stable dans le temps. |
deepseek-v4-pro-0813 | 0,33 $ | — | 0,65 $ | Version datée, figée, du modèle pro. |
Les versions datées n'ont pas de cache de prompt : toute l'entrée est facturée au prix normal.
Choisir la source : variantes :p1 et :p2
deepseek-v4.1-flash et deepseek-v4-pro sont servis par deux sources d'inférence indépendantes. Vous pouvez laisser la passerelle choisir ou imposer une source en ajoutant un suffixe au nom du modèle. Le prix est le même quelle que soit la variante.
| Nom demandé | Comportement |
|---|---|
deepseek-v4.1-flash | Automatique (recommandé). Source 1 d'abord ; si elle est indisponible ou saturée, la requête bascule sur la source 2, sans rien changer de votre côté. |
deepseek-v4.1-flash:p1 | Source 1 uniquement. Cache de prompt actif. |
deepseek-v4.1-flash:p2 | Source 2 uniquement. Pas de cache de prompt sur ce modèle : l'entrée est toujours facturée au prix normal. |
deepseek-v4-pro | Automatique (recommandé). Source 2 d'abord, bascule sur la source 1. |
deepseek-v4-pro:p1 / :p2 | Source imposée. Cache de prompt actif sur :p2. |
Avec une variante :p1 ou :p2, il n'y a pas de bascule : si la source choisie est saturée, vous recevez une erreur 503. Réessayez, ou passez sur le nom sans suffixe. Utilisez les variantes pour comparer les sources sur vos propres requêtes (latence, qualité, stabilité) ou pour garder un comportement constant. Le champ model de la réponse reprend exactement le nom que vous avez demandé.
La liste à jour est disponible à tout moment, même avec un solde nul :
curl https://api.obscuragate.com/v1/models -H "Authorization: Bearer $OBSCURAGATE_API_KEY"
Combien coûte une requête ?
Coût = (entrée hors cache × prix entrée) + (entrée en cache × prix cache) + (sortie × prix sortie), chaque volume étant exprimé en millions de tokens. Le débit se fait au micro-dollar près après chaque requête.
Exemple : un chatbot qui envoie 24 500 tokens de contexte (dont 59 % déjà en cache) et reçoit 156 tokens de réponse avec deepseek-v4.1-flash :
10 045 tokens hors cache × 0,105 $ / 1 M = 0,001055 $
14 455 tokens en cache × 0,00315 $ / 1 M = 0,000046 $
156 tokens de sortie × 0,315 $ / 1 M = 0,000049 $
total ≈ 0,00115 $ par réponse
Soit environ 870 réponses par dollar.
Les modèles DeepSeek V4 « réfléchissent » avant de répondre. Ces tokens de raisonnement sont comptés dans completion_tokens (détail dans completion_tokens_details.reasoning_tokens) et facturés au prix de sortie, comme partout ailleurs. Prévoyez un max_tokens suffisant pour laisser la place au raisonnement et à la réponse.
Cache de prompt
Le cache est automatique : rien à activer. Quand le début d'une requête (son préfixe) est identique à celui d'une requête récente, ces tokens sont lus en cache et facturés environ 33 fois moins cher.
Pour en profiter au maximum :
- Mettez le contenu stable au début : prompt système, instructions, documents de référence, exemples.
- Mettez le contenu variable à la fin : question de l'utilisateur, horodatage, identifiants.
- Dans une conversation, renvoyez l'historique tel quel et ajoutez simplement les nouveaux messages à la fin.
- Évitez d'insérer une date ou un identifiant unique dans le prompt système : cela casse le préfixe à chaque requête.
Le cache fonctionne par blocs ; les tout derniers tokens d'un prompt sont toujours comptés hors cache. Le nombre de tokens lus en cache est indiqué dans la réponse.
Chat completions
POST/v1/chat/completions
Format identique à l'API OpenAI. Paramètres principaux :
| Paramètre | Type | Description |
|---|---|---|
model | string | Obligatoire. Un des modèles listés ci-dessus. |
messages | array | Obligatoire. Rôles system, user, assistant, tool. |
max_tokens | integer | Plafond de tokens générés (raisonnement inclus). |
temperature, top_p | number | Échantillonnage. |
stream | boolean | Réponse en flux SSE, voir Streaming. |
tools, tool_choice | array, string/object | Appel de fonctions au format OpenAI. |
response_format | object | {"type":"json_object"} pour forcer une sortie JSON. |
stop | string/array | Séquences d'arrêt. |
Réponse
{
"id": "42dcb00613e20659ae05b8ce95c8ba15",
"object": "chat.completion",
"model": "deepseek-v4.1-flash",
"choices": [{
"index": 0,
"message": { "role": "assistant", "content": "Bonjour ! Comment puis-je vous aider ?" },
"finish_reason": "stop"
}],
"usage": {
"prompt_tokens": 5922,
"prompt_tokens_details": { "cached_tokens": 5760 },
"prompt_cache_hit_tokens": 5760,
"prompt_cache_miss_tokens": 162,
"completion_tokens": 12,
"completion_tokens_details": { "reasoning_tokens": 5 },
"total_tokens": 5934
}
}
Streaming
Avec "stream": true, la réponse arrive en Server-Sent Events (data: {…}), terminée par data: [DONE]. Le dernier événement contient le bloc usage : il est ajouté automatiquement, inutile de passer stream_options.
stream = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Écris un haïku sur la mer."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
if chunk.usage:
print("\n", chunk.usage)curl -N https://api.obscuragate.com/v1/chat/completions \
-H "Authorization: Bearer $OBSCURAGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4.1-flash","stream":true,
"messages":[{"role":"user","content":"Écris un haïku sur la mer."}]}'Lire l'usage
Chaque réponse indique exactement ce qui vous est facturé :
| Champ | Signification | Prix appliqué |
|---|---|---|
prompt_tokens | Total des tokens d'entrée (cache compris) | — |
prompt_tokens_details.cached_tokens | Part de l'entrée lue en cache (aussi prompt_cache_hit_tokens) | Entrée en cache |
prompt_cache_miss_tokens | Part de l'entrée hors cache | Entrée |
completion_tokens | Tokens générés, raisonnement compris | Sortie |
Solde
Votre compte fonctionne avec un solde prépayé en dollars US. Chaque requête réussie est débitée de son coût exact. Quand le solde est épuisé, les requêtes renvoient 402 jusqu'à la prochaine recharge (la liste des modèles et la facturation restent accessibles).
GET/v1/billing/balance
curl https://api.obscuragate.com/v1/billing/balance -H "Authorization: Bearer $OBSCURAGATE_API_KEY"
{"balance_usd": 204.94, "client": "clt_…"}
Recharger en stablecoins
Les recharges se font en stablecoins (USDT, USDC, DAI…), sur la blockchain de votre choix. Montant minimum : 20 $ (certains réseaux imposent un minimum un peu plus élevé, indiqué en cas de refus). Maximum : 10 000 $ par recharge. Le solde est crédité automatiquement une fois le paiement confirmé sur la blockchain, en général en quelques minutes.
Réseaux acceptés
GET/v1/billing/currencies renvoie la liste complète et les montants min/max. Les plus courants :
| Code | Jeton | Réseau |
|---|---|---|
usdttrc20 | USDT | Tron (TRC-20), frais réseau très bas |
usdtbsc | USDT | BNB Smart Chain (BEP-20) |
usdtsol | USDT | Solana |
usdterc20 | USDT | Ethereum (ERC-20) |
usdcsol | USDC | Solana |
usdcbase | USDC | Base |
usdcbsc | USDC | BNB Smart Chain |
usdcerc20 | USDC | Ethereum (ERC-20) |
Option A : par API (adresse de dépôt)
POST/v1/billing/topup. Vous choisissez le réseau, l'API renvoie l'adresse et le montant exact à envoyer.
curl -X POST https://api.obscuragate.com/v1/billing/topup \
-H "Authorization: Bearer $OBSCURAGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount_usd": 50, "pay_currency": "usdttrc20"}'
{
"payment_id": "5223464798",
"pay_address": "T…",
"pay_amount": "50.21",
"pay_currency": "usdttrc20",
"network": "trx",
"payin_extra_id": "",
"amount_usd": 50,
"status": "waiting",
"expires_at": "2026-11-18T10:00:00.000Z"
}
Envoyez exactement pay_amount, sur le réseau indiqué, avant expires_at. Si payin_extra_id n'est pas vide (memo/tag), il est obligatoire. Une adresse sert pour un seul paiement : créez-en une nouvelle à chaque recharge. Un envoi incomplet n'est pas crédité automatiquement.
Option B : lien de paiement
POST/v1/billing/invoice renvoie une page de paiement hébergée, pratique depuis un wallet mobile. pay_currency est facultatif ; sans lui, le réseau se choisit sur la page.
curl -X POST https://api.obscuragate.com/v1/billing/invoice \
-H "Authorization: Bearer $OBSCURAGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount_usd": 50}'
{
"invoice_id": "…",
"payment_url": "https://…",
"amount_usd": 50,
"pay_currency": ""
}
Payez uniquement avec un stablecoin de la liste. Un paiement dans une autre cryptomonnaie n'est pas crédité automatiquement et demande une vérification manuelle.
Pour suivre l'arrivée des fonds, interrogez /v1/billing/balance.
Erreurs
Les erreurs suivent le format OpenAI : {"error": {"type": "…", "message": "…"}}.
| Code | Cause | Que faire |
|---|---|---|
400 | Requête invalide ou modèle inconnu | Vérifiez le JSON et le nom du modèle (/v1/models). |
401 | Clé absente, invalide ou désactivée | Vérifiez l'en-tête Authorization: Bearer …. |
402 | Solde épuisé (insufficient_balance) | Rechargez, puis réessayez. |
429 | Trop de requêtes | Réessayez avec un délai croissant (backoff exponentiel). |
500, 502, 503, 504 | Modèle momentanément indisponible ou surchargé (service_unavailable) | Réessayez après quelques secondes, ou utilisez le nom sans suffixe (bascule automatique) ou l'autre variante. Une requête en échec n'est pas facturée. |
Délai maximal par requête : 10 minutes. Taille maximale d'une requête : 32 Mo.
Confidentialité
- Le contenu de vos requêtes et des réponses n'est pas enregistré par la passerelle. Seuls les compteurs de tokens et le coût de chaque appel sont conservés, pour la facturation.
- Votre clé est stockée sous forme hachée : personne ne peut la relire, pas même nous. En cas de perte ou de fuite, demandez une nouvelle clé : l'ancienne sera désactivée.
- Toutes les connexions sont chiffrées (HTTPS/TLS).