Aller au contenu
promptix

Documentation Promptix

Une seule API compatible OpenAI pour plus de 450 modèles d'IA, payée en dinars tunisiens. Découvrez comment vous authentifier, envoyer des requêtes, recevoir les réponses en streaming et maîtriser vos dépenses.

Promptix est une passerelle API pour les développeurs et les entreprises en Tunisie. Une seule clé API donne accès à plus de 450 modèles d'OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, Qwen et d'autres, via un endpoint unique au format OpenAI Chat Completions. Vous payez en dinars tunisiens via Flouci et recevez vos factures en TND : aucune carte internationale n'est nécessaire.

URL de base

Toutes les requêtes API utilisent cette URL de base. Les chemins de cette documentation sont relatifs à celle-ci.

https://promptix.tn/api/v1

L'API étant compatible OpenAI, un code existant ne demande en général que deux changements : l'URL de base et la clé API. Les SDK officiels d'OpenAI, le Vercel AI SDK et LangChain fonctionnent sans autre modification.

Démarrage rapide

  1. Créez un compte, puis ouvrez Facturation et ajoutez des crédits (à partir de 5 TND).
  2. Rendez-vous dans Clés API, créez une clé et copiez-la. Elle n'est affichée qu'une seule fois.
  3. Exportez-la dans une variable d'environnement et envoyez une requête.
terminalbash
export PROMPTIX_API_KEY="sk_your_key_here"
curl https://promptix.tn/api/v1/chat/completions \  -H "Authorization: Bearer $PROMPTIX_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "openai/gpt-6-luna",    "messages": [      { "role": "system", "content": "You are a concise assistant." },      { "role": "user", "content": "Give me three names for a café in Sidi Bou Said." }    ]  }'

La réponse est un objet chat.completion standard. Son id permet de retrouver le coût exact de la requête en TND. Le guide de démarrage complet détaille chaque étape.

Notions clés

  • Les identifiants de modèles sont préfixés par le fournisseur, par exemple openai/gpt-6-luna ou anthropic/claude-sonnet-5. Parcourez-les dans le catalogue des modèles.
  • Crédits : 1 crédit = 1 TND. Chaque requête est déduite de votre solde une fois terminée, selon les tokens consommés. Voir Facturation et crédits.
  • Les clés API peuvent avoir un plafond de dépenses mensuel en TND, pour qu'un projet ne puisse pas épuiser tout votre solde.
  • Le streaming utilise les événements server-sent, exactement comme OpenAI. Voir Streaming.

Guides

Démarrage rapideCréez une clé et envoyez votre première requête en cinq minutes.AuthentificationJetons Bearer, plafonds, rotation et révocation des clés.Chat completionsTous les champs de la requête, le format de réponse et des exemples.StreamingÉvénements server-sent, format des chunks et marqueur [DONE].Erreurs et limitesCodes HTTP, format des erreurs et quand réessayer.Facturation et créditsCrédits en TND, TVA, frais de plateforme et coût par requête.

SDK et frameworks

OpenAI Pythonpip install openai, puis définissez base_url.OpenAI Node.jsnpm install openai, puis définissez baseURL.Vercel AI SDKcreateOpenAI({ baseURL }) et promptix.chat(modèle).LangChainChatOpenAI avec openai_api_base, en Python et JavaScript.

Référence API complète

Tous les endpoints et schémas sont également décrits dans la référence API.