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

URL de basehttps://api.obscuragate.com/v1
AuthentificationAuthorization: Bearer sk-…
FormatOpenAI Chat Completions

Dé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)

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èleEntréeEntrée en cacheSortieUsage conseillé
deepseek-v4.1-flashrecommandé0,105 $0,00315 $0,315 $Chat, agents, extraction, gros volumes. Le meilleur rapport qualité/prix.
deepseek-v4-flash0,105 $0,00315 $0,315 $Génération précédente du modèle rapide.
deepseek-v4-pro0,33 $0,0098 $0,65 $Raisonnement difficile, code, tâches longues où la qualité prime.
deepseek-v4.1-flash-1017
deepseek-v4-flash-0731
0,105 $—0,315 $Versions datées, figées : comportement stable dans le temps.
deepseek-v4-pro-08130,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-flashAutomatique (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:p1Source 1 uniquement. Cache de prompt actif.
deepseek-v4.1-flash:p2Source 2 uniquement. Pas de cache de prompt sur ce modèle : l'entrée est toujours facturée au prix normal.
deepseek-v4-proAutomatique (recommandé). Source 2 d'abord, bascule sur la source 1.
deepseek-v4-pro:p1 / :p2Source 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ètreTypeDescription
modelstringObligatoire. Un des modèles listés ci-dessus.
messagesarrayObligatoire. Rôles system, user, assistant, tool.
max_tokensintegerPlafond de tokens générés (raisonnement inclus).
temperature, top_pnumberÉchantillonnage.
streambooleanRéponse en flux SSE, voir Streaming.
tools, tool_choicearray, string/objectAppel de fonctions au format OpenAI.
response_formatobject{"type":"json_object"} pour forcer une sortie JSON.
stopstring/arraySé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)

Lire l'usage

Chaque réponse indique exactement ce qui vous est facturé :

ChampSignificationPrix appliqué
prompt_tokensTotal des tokens d'entrée (cache compris)—
prompt_tokens_details.cached_tokensPart de l'entrée lue en cache (aussi prompt_cache_hit_tokens)Entrée en cache
prompt_cache_miss_tokensPart de l'entrée hors cacheEntrée
completion_tokensTokens générés, raisonnement comprisSortie

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 :

CodeJetonRéseau
usdttrc20USDTTron (TRC-20), frais réseau très bas
usdtbscUSDTBNB Smart Chain (BEP-20)
usdtsolUSDTSolana
usdterc20USDTEthereum (ERC-20)
usdcsolUSDCSolana
usdcbaseUSDCBase
usdcbscUSDCBNB Smart Chain
usdcerc20USDCEthereum (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": "…"}}.

CodeCauseQue faire
400Requête invalide ou modèle inconnuVérifiez le JSON et le nom du modèle (/v1/models).
401Clé absente, invalide ou désactivéeVérifiez l'en-tête Authorization: Bearer ….
402Solde épuisé (insufficient_balance)Rechargez, puis réessayez.
429Trop de requêtesRéessayez avec un délai croissant (backoff exponentiel).
500, 502, 503, 504Modè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).