Votre SDK d'IA peut facturer deux fois la même requête. Voici les 5 garanties intégrées au nôtre
Votre SDK d'IA peut facturer deux fois la même requête. Nous avons intégré cinq garanties de production à devupai, notre SDK Python officiel, et mesuré chacune en production.
Sur cette page
La plupart des équipes se connectent à une API d'IA de la même façon : installer la bibliothèque OpenAI, changer l'URL de base, livrer. DEVUP AI prend en charge exactement cela, et le fera toujours. Mais une connexion n'est pas un contrat. Dès qu'une fonctionnalité d'IA est en production et que chaque requête est facturée, cinq questions décident si vous pouvez faire confiance au système et à votre facture.
Combien a coûté cette requête ? Qu'est-ce que la passerelle y a changé ? Si le réseau tombe, mon code paiera-t-il deux fois ? Quand un long traitement se termine, le résultat vient-il vraiment de vous, et le traiterai-je une seule fois ? Le paquet que j'ai installé est-il bien celui que vous avez construit ?
Nous avons construit devupai, le SDK Python officiel de DEVUP AI, pour répondre aux cinq dans le code. Cet article montre chaque garantie avec des sorties réelles de production et des mesures que vous pouvez reproduire sur votre propre machine.

Pourquoi un SDK natif quand la compatibilité fonctionne déjà ?
La bibliothèque OpenAI excelle dans ce pour quoi elle a été conçue : l'API d'OpenAI. Ses types de réponse décrivent les champs d'OpenAI, et ses règles de nouvelle tentative sont réglées pour un client généraliste.
Une réponse de DEVUP AI contient davantage. Chaque réponse porte un identifiant de requête. Les réponses non streamées portent un bloc _devup avec le coût de la requête et votre solde restant. Chaque réponse, streamée ou non, porte un en-tête X-DEVUP-Warnings quand la passerelle a adapté quelque chose. La bibliothèque OpenAI reçoit tout cela et n'en comprend rien.
Nous avons donc gardé la compatibilité comme plancher, et construit le SDK comme plafond : un seul client qui parle toute l'API, avec des types pour tout ce que DEVUP AI renvoie.
Garantie 1 : vous savez ce que chaque requête a coûté
Voici la même requête, envoyée le 22 novembre 2026 avec les deux bibliothèques.
Avec la bibliothèque OpenAI, les données de facturation sont là, mais seulement sous forme de dictionnaire non typé, caché dans les champs supplémentaires du modèle :
type(response): ChatCompletion
hasattr(response, 'devup'): False
response.model_extra keys: ['_devup']
type(model_extra['_devup']): dictAvec devupai, c'est un champ typé, avec son propre modèle, DevUpBilling :
from devupai import DevupAI
client = DevupAI() # reads DEVUP_API_KEY
completion = client.chat.completions.create(
model="deepseek-ai/DeepSeek-V4.1-Flash-1017",
messages=[{"role": "user", "content": "In one sentence: what is a reranker?"}],
max_tokens=48,
)
print(completion.devup)cost_dzd=0.0098 balance_dzd=728.75 request_id='req_de6b209205a344ebba841dd463b67c17' warnings=None note=Nonecost_dzd est typé float | None : votre éditeur le complète et votre vérificateur de types le contrôle. Le coût devient une donnée sur laquelle construire. Un SaaS peut mesurer la consommation de chacun de ses clients en dinars, sans estimation et sans export de facturation séparé :
from collections import defaultdict
from devupai import DevupAI
client = DevupAI()
spend_by_customer: defaultdict[str, float] = defaultdict(float) # in production, store money as Decimal or in your database
def answer(customer_id: str, question: str) -> str:
completion = client.chat.completions.create(
model="deepseek-ai/DeepSeek-V4.1-Flash-1017",
messages=[{"role": "user", "content": question}],
)
if completion.devup is not None and completion.devup.cost_dzd is not None:
spend_by_customer[customer_id] += completion.devup.cost_dzd
message = completion.choices[0].message
return message.content if message else ""devup.balance_dzd revient avec la même réponse : un traitement par lots peut s'arrêter avant que le solde ne s'épuise, sans interroger un autre endpoint. Le bloc devup accompagne les réponses non streamées. Les réponses streamées donnent leur usage en tokens dans le dernier chunk.
Garantie 2 : vous savez ce que la passerelle a changé dans votre requête
DEVUP AI sert plus de 200 modèles de nombreux créateurs, et ils n'acceptent pas tous les mêmes paramètres. Certains modèles de raisonnement, par exemple, ne prennent ni temperature ni top_p.
Rejeter ces requêtes casserait tous les outils compatibles OpenAI qui envoient des valeurs d'échantillonnage par défaut. DEVUP AI y répond quand même, et vous dit exactement ce qu'elle n'a pas appliqué, sous forme de notice. Les codes de notice sont stables, triés, et ne reprennent jamais votre prompt ni vos valeurs. La référence des erreurs documente chaque code, de parameter_not_supported à structured_output_not_matched et max_tokens_capped_by_budget.
devupai expose ces codes directement. Envoyé le 22 novembre 2026 à openai/gpt-5.4-nano avec temperature=0.2 :
result = client.chat.completions.with_response.create(
model="openai/gpt-5.4-nano",
messages=[{"role": "user", "content": "Reply with the word OK."}],
temperature=0.2,
max_completion_tokens=200,
)
print(result.warnings) # codes from the X-DEVUP-Warnings header
print(result.data.devup.warnings)['parameter_not_supported']
["This model does not take the 'temperature' parameter; the request was answered without it."]Les streams exposent les mêmes codes avant l'arrivée du premier chunk, pour que votre code décide avant d'afficher le moindre token :
before the first chunk -> request_id: req_8d72f696679a4fbcb0f878c8a2cc8939 | warnings: ['parameter_not_supported']Comme les codes sont stables, vous pouvez en faire un test. Celui-ci fait échouer votre CI le jour où un changement de prompt ou de modèle amène la passerelle à ignorer un paramètre, ou à renvoyer un JSON qui ne respecte pas votre schéma :
from devupai import DevupAI
client = DevupAI()
FORBIDDEN = {"parameter_not_supported", "structured_output_not_matched"}
def test_invoice_extraction_is_applied_as_written() -> None:
result = client.chat.completions.with_response.create(
model="openai/gpt-5.4-nano",
messages=[{"role": "user", "content": "Extract the invoice total: 1,250 DZD."}],
response_format={
"type": "json_schema",
"json_schema": {
"name": "invoice_total",
"schema": {
"type": "object",
"properties": {"total_dzd": {"type": "number"}},
"required": ["total_dzd"],
"additionalProperties": False,
},
},
},
max_completion_tokens=200,
)
assert not FORBIDDEN & set(result.warnings), result.warningsUne adaptation silencieuse reste invisible jusqu'au jour où elle casse quelque chose. DEVUP AI vous la signale, et le SDK la rend testable.
Garantie 3 : une requête facturée n'est jamais renvoyée à l'aveugle
C'est la garantie à laquelle la plupart des équipes ne pensent qu'après qu'elle leur a coûté.
Imaginez une longue réponse. Votre client attend 60 secondes et abandonne, mais le modèle écrivait encore. Sur une API qui facture chaque requête terminée, ce travail est peut-être déjà payé. Et votre SDK renvoie la même requête de lui-même. Vous pouvez payer deux fois une seule réponse, alors que vos logs ne montrent qu'un appel.
Nous avons mesuré combien de fois des SDK renvoient la même requête. Un serveur simulé en local répond à une chat completion avec une panne à la fois, et compte combien de fois la requête arrive. Les deux bibliothèques ont tourné avec leurs réglages par défaut et un délai d'attente d'une seconde (22 novembre 2026, Python 3.13) :
| SDK | 500 | 502 | 503 | 504 | 429 | délai de lecture dépassé | connexion coupée après l'envoi |
|---|---|---|---|---|---|---|---|
openai 3.57.0 | 3 | 3 | 3 | 3 | 3 | 3 | 3 |
devupai 1.0.1 | 1 | 1 | 3 | 1 | 3 | 1 | 1 |

Un client généraliste réessaie largement, et pour beaucoup d'API c'est un choix raisonnable. devupai est le SDK d'une plateforme de facturation, il suit donc une règle : une requête facturée n'est renvoyée que lorsqu'on sait qu'elle n'a pas été exécutée.
Un
429ou un503signifie en général que la requête a été refusée avant tout travail. Le SDK attend la durée indiquée parretry-after-msouRetry-After, puis réessaie.Une connexion qui ne s'est jamais ouverte ne nous a jamais atteints : elle est réessayée aussi.
Quand la plateforme ne peut pas garantir qu'une requête n'a pas été exécutée, elle le signale avec
x-should-retry: false, et le SDK ne renvoie rien, quel que soit le statut. Sur le même serveur de test, un503portant cet en-tête arrive une seule fois au lieu de trois.Toute autre panne (délai de lecture dépassé, connexion coupée,
500,502ou504) est renvoyée à votre code avec son identifiant de requête. C'est vous qui décidez de la suite.
Le test est open source : sdk-retry-test tourne en local, ne demande aucune clé API, et mesure n'importe quel SDK que vous y ajoutez.
La plateforme vous protège aussi
Le SDK est une couche. La plateforme est l'autre. Nous l'avons mesurée en production le 22 novembre 2026, avec la même longue requête envoyée deux fois :
CONTROL client waits for the answer answered in 29.2 s balance change: 0.51 DZD
ABORT client gives up after 3 s APITimeoutError balance change: 0.0 DZDQuand votre code cesse d'attendre avant que la réponse soit complète, DEVUP AI annule la requête et ne facture rien. Quand un modèle échoue de son côté, vous recevez un 502 et ne payez rien. Quand vous arrêtez un stream, vous payez l'entrée et la sortie déjà envoyée, jamais plus.
Deux couches, chacune suffisante à elle seule. Voilà ce que veut dire la défense en profondeur appliquée à une facture.
Quand vous voulez réessayer vous-même, devupai le rend explicite :
from devupai import APITimeoutError, DevupAI
client = DevupAI(max_retries=0) # nothing is ever resent for you
try:
completion = client.chat.completions.create(
model="deepseek-ai/DeepSeek-V4.1-Flash-1017",
messages=[{"role": "user", "content": "Summarize this contract."}],
timeout=60,
)
except APITimeoutError:
# Your decision: retry, queue for later, or tell the user.
raiseUn hook on_debug signale chaque nouvelle tentative du SDK, avec le numéro de l'essai, le statut et l'attente.
Garantie 4 : les longs traitements reviennent signés, et vous les traitez une seule fois
Certains traitements prennent des minutes : une longue génération, un lot de documents, une vidéo. Garder une connexion HTTP ouverte pendant ce temps est fragile.
L'API native de DEVUP AI accepte plutôt une URL webhook. L'API répond immédiatement avec queued, puis envoie le résultat à votre endpoint quand il est prêt. Les webhooks sont une fonctionnalité de l'API native : la bibliothèque OpenAI n'a aucune méthode pour eux.
from devupai import DevupAI
client = DevupAI()
job = client.inference.run(
"deepseek-ai/DeepSeek-V4-Pro",
{
"input": "Draft a 2,000-word technical report on solar farms in the Sahara.",
"parameters": {"max_new_tokens": 3000},
"webhook": "https://your-app.com/devupai-webhook",
},
)
print(job)Chaque livraison est signée en HMAC-SHA256 sur le corps brut et un horodatage, dans l'en-tête X-DevUp-Signature. devupai la vérifie pour vous, en local, sans rien envoyer :
import os
from collections.abc import Mapping
from devupai import DevupWebhookVerificationError, construct_webhook_event
from devupai.types import WebhookErrorPayload
SECRET = os.environ["DEVUP_WEBHOOK_SECRET"]
processed: set[str] = set() # use your database in production
def handle_delivery(raw_body: bytes, headers: Mapping[str, str]) -> int:
h = {name.lower(): value for name, value in headers.items()}
try: # verify first: unsigned requests learn nothing
event = construct_webhook_event(
raw_body=raw_body,
signature_header=h.get("x-devup-signature", ""),
secret=SECRET,
)
except DevupWebhookVerificationError as err:
print("rejected:", err.reason)
return 400
delivery_id = h.get("x-devup-delivery-id", "")
if delivery_id and delivery_id in processed:
return 200 # a verified retry of a delivery we already handled
if isinstance(event, WebhookErrorPayload):
print("job failed:", event.error.type)
else:
print("result:", event.results, "| cost:", event.cost_dzd, "DZD")
if delivery_id:
processed.add(delivery_id)
return 200Nous avons soumis quatre livraisons au vérificateur :
| Livraison | Résultat |
|---|---|
| Correctement signée | acceptée, WebhookSuccessPayload typé avec cost_dzd |
| Corps modifié d'un seul caractère | rejetée : no_matching_signature |
| Une livraison valide rejouée une heure plus tard | rejetée : timestamp_outside_tolerance |
| Pendant une rotation de secret : une ancienne et une nouvelle signature | acceptée |
Ce dernier cas compte. Vous pouvez changer votre secret de webhook sans interruption, car les deux secrets sont valides pendant la fenêtre de rotation.
Dédupliquez sur X-DevUp-Delivery-Id, jamais sur la signature. L'identifiant de livraison reste le même d'un essai à l'autre, alors que la signature est recalculée à chaque tentative. Si votre endpoint est hors ligne, DEVUP AI insiste, avec jusqu'à 8 tentatives de livraison sur environ deux heures (documentation des webhooks).
Les endpoints hors de portée de la compatibilité
Les webhooks ne sont pas la seule partie de l'API que la bibliothèque OpenAI ne peut pas appeler. devupai couvre toute la plateforme depuis un seul client : chat, Responses API, images, embeddings, reranking, synthèse vocale, transcription, vidéo, inférence native, modèles, solde et santé du service.
Le reranking en est un bon exemple. C'est l'étape qui rend la génération augmentée par récupération (RAG) précise : après qu'une recherche vectorielle rapide a renvoyé 50 passages candidats, un reranker lit chacun face à la question et garde les meilleurs. Avec devupai, c'est un seul appel, avec le coût dans la réponse comme pour tout le reste :
passages = [
"Top up your DEVUP AI balance in dinars with BaridiMob, CIB or Edahabia.",
"Algiers is the capital of Algeria.",
"Prepaid balance top-ups accept Algerian payment cards.",
]
ranked = client.rerank.create(
model="Qwen/Qwen3-Reranker-4B",
query="How do I pay for API usage from Algeria?",
documents=passages,
top_n=3,
)
for r in ranked.results:
print(f"{r.relevance_score:.4f} {passages[r.index]}")
print("cost:", ranked.devup.cost_dzd if ranked.devup else None, "DZD")Sortie réelle, 22 novembre 2026. Les deux passages sur le paiement arrivent en tête, et la phrase vraie mais hors sujet sur Alger est reléguée en bas :
0.9975 Top up your DEVUP AI balance in dinars with BaridiMob, CIB or Edahabia.
0.9962 Prepaid balance top-ups accept Algerian payment cards.
0.0361 Algiers is the capital of Algeria.
cost: 0.0025 DZDGarantie 5 : le paquet que vous avez installé est celui que nous avons construit
Les attaques sur la chaîne d'approvisionnement visent les paquets, pas seulement les serveurs. Une faute de frappe dans un nom de paquet ou un jeton de publication volé peut placer le code de quelqu'un d'autre dans votre application.
devupai est publié via le Trusted Publishing de PyPI : l'envoi utilise un identifiant de courte durée délivré au workflow de publication, pas un mot de passe ni un jeton stocké. Chaque version est construite par un workflow GitHub Actions dans le dépôt public, et PyPI conserve une attestation signée pour chaque fichier (PEP 740). L'attestation lie le fichier exact :
au dépôt
devupai-platform/devupai-python;au workflow
release.yml;à l'environnement protégé
pypi.
Vous pouvez le vérifier vous-même, en une commande :
pip install pypi-attestations
python -m pypi_attestations verify pypi \
--repository https://github.com/devupai-platform/devupai-python \
pypi:devupai-1.0.1-py3-none-any.whlOK: devupai-1.0.1-py3-none-any.whlLa vérification échoue aussi quand elle le doit. Pointez-la vers n'importe quel autre dépôt, et elle refuse :
Verification failed: provenance was signed by repository "devupai-platform/devupai-python", expected "someone-else/fake"Le paquet reste petit et auditable. Il ne dépend que de httpx et pydantic, fournit ses informations de type (py.typed), et est sous licence MIT, avec un changelog public.
La provenance continue à l'exécution. Chaque réponse, stream et erreur porte l'identifiant de requête attribué par DEVUP AI (x-request-id). Si vous envoyez votre propre x-client-request-id, il revient aussi : un seul identifiant suit la requête de vos logs jusqu'à notre support.

Quand garder la bibliothèque OpenAI
Utilisez celle qui convient au code que vous possédez.
Les frameworks qui attendent un client OpenAI, comme LangChain, CrewAI ou l'OpenAI Agents SDK, se connectent via l'endpoint compatible OpenAI de DEVUP AI. Ils continuent de fonctionner, et les guides d'intégration montrent comment.
Le code que vous écrivez et exécutez vous-même, comme un backend, un worker ou un pipeline de données, obtient les cinq garanties avec
devupai.
Les deux sont facturés sur le même solde en dinars, et vous pouvez les combiner dans un même projet.
Migrer en deux lignes
- from openai import OpenAI
- client = OpenAI(api_key=os.environ["DEVUP_API_KEY"], base_url="https://api.devupai.com/v1")
+ from devupai import DevupAI
+ client = DevupAI() # reads DEVUP_API_KEYclient.chat.completions.create(...) garde le même nom et les mêmes champs de requête. Ce qui change, c'est ce qui revient : coût typé, notices, identifiants de requête et nouvelles tentatives sûres. Le guide du SDK Python couvre le streaming, l'async, les fichiers en entrée, les délais d'attente et chaque type d'erreur.
Questions fréquentes
devupai est-il un fork de la bibliothèque OpenAI ?
Non. C'est un SDK indépendant, construit à partir de la spécification OpenAPI de DEVUP AI, avec sa propre politique de nouvelles tentatives et ses propres types pour tout ce que l'API renvoie. Les champs de requête gardent les noms habituels, donc la migration est rapide.
Quelles versions de Python sont prises en charge ?
Python 3.11 ou plus récent. Il fournit un client synchrone, DevupAI, et un client asynchrone, AsyncDevupAI, avec les mêmes méthodes et options.
Comment voir le coût d'une requête en dinars ?
Lisez completion.devup.cost_dzd sur n'importe quelle réponse non streamée. Le même bloc donne balance_dzd et request_id. Pour les streams, l'usage en tokens arrive dans le dernier chunk.
Un SDK peut-il me facturer deux fois la même requête ?
Sur une API facturée à la requête, oui : un client qui renvoie une requête après un délai dépassé peut payer un travail déjà fait. devupai ne renvoie jamais une requête facturée à moins de savoir qu'elle n'a pas été exécutée. Et en plus, DEVUP AI ne facture pas une requête que vous abandonnez avant que la réponse soit complète.
Prend-il en charge le streaming et l'async ?
Oui. Les streams sont typés. Ils exposent l'identifiant de requête et les codes de notice avant le premier chunk, et donnent l'usage en tokens à la fin. Chaque méthode existe aussi sur AsyncDevupAI avec await.
Comment vérifier que le paquet est authentique ?
Lancez pypi-attestations verify pypi avec le dépôt devupai-platform/devupai-python, comme montré plus haut. La commande vérifie la provenance signée que PyPI conserve pour chaque fichier de version.
Puis-je continuer à utiliser la bibliothèque OpenAI avec DEVUP AI ?
Oui. L'endpoint compatible OpenAI https://api.devupai.com/v1 reste pleinement pris en charge. Utilisez devupai là où vous voulez les cinq garanties, et la bibliothèque OpenAI là où un framework l'attend.
Résumé rapide pour les équipes Python
devupai est le SDK Python officiel de DEVUP AI, pour Python 3.11 et plus, avec des clients synchrone et asynchrone. Il vous donne cinq garanties de production :
Le coût de chaque requête en dinars, dans un champ typé.
Les notices de la passerelle sous forme de codes stables, testables en CI.
Aucun renvoi à l'aveugle d'une requête facturée, mesuré côte à côte avec la bibliothèque OpenAI.
Des webhooks signés, protégés contre le rejeu, avec rotation des secrets.
Des fichiers de version avec une provenance de build signée, vérifiable en une commande.
La plateforme ajoute sa propre couche : une requête abandonnée avant que la réponse soit complète n'est pas facturée. Installez-le avec pip install devupai. Le code source est sur GitHub, le paquet sur PyPI, et le guide complet dans la documentation.
Pour auditer n'importe quelle API d'IA de façon neutre, lisez notre guide des API d'IA et du GPU cloud en Algérie.
Créez votre compte DEVUP AI et lancez pip install devupai dès aujourd'hui.
À propos de DEVUP AI
Une infrastructure d’IA pour les développeurs : modèles, calcul et API média, avec une facturation locale en DZD via BaridiMob et Edahabia.
Obtenir une clé API