Aller au contenu
promptix

Démarrage rapide

Créez une clé API, envoyez votre première requête et consultez son coût, en moins de cinq minutes.

Ce guide vous mène d'un compte tout neuf à une première requête fonctionnelle. Il vous faut un compte Promptix, quelques dinars de crédit et un terminal. Si vous utilisez déjà le SDK OpenAI, seules l'URL de base et la clé changent.

Étapes

Ajoutez des crédits

Connectez-vous, ouvrez Facturation et rechargez votre solde avec Flouci. Les crédits sont en dinars (1 crédit = 1 TND) ; la recharge minimale est de 5 TND. La TVA (19 %) et les frais de plateforme (10 %) s'ajoutent au montant payé et sont affichés avant la confirmation. Voir Facturation et crédits.

Créez une clé API

Dans Clés API, cliquez sur Créer une clé, donnez-lui un nom (par exemple celui du projet concerné) et, si vous le souhaitez, un plafond de dépenses mensuel en TND. Copiez la clé : elle commence par sk_ et n'est affichée qu'une seule fois.

terminalbash
export PROMPTIX_API_KEY="sk_your_key_here"

Gardez votre clé côté serveur

Toute personne qui possède la clé peut dépenser vos crédits. Ne l'intégrez jamais dans du code navigateur ou mobile et ne la versionnez jamais dans un dépôt. Appelez Promptix depuis votre backend.

Installez un SDK (facultatif)

Promptix utilise le format OpenAI : les SDK officiels d'OpenAI fonctionnent tels quels. Vous pouvez aussi utiliser directement HTTP avec curl ou n'importe quel client HTTP.

pip install openai

Envoyez votre première requête

Envoyez une chat completion à POST /chat/completions. Le champ model accepte n'importe quel identifiant du catalogue des modèles.

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." }    ]  }'

Vous recevez une chat completion OpenAI standard :

200 OKJSON
{  "id": "gen-1758880023-kQ3vX8mZpL2nR7tW",  "object": "chat.completion",  "created": 1758880023,  "model": "openai/gpt-6-luna",  "provider": "OpenAI",  "choices": [    {      "index": 0,      "finish_reason": "stop",      "message": {        "role": "assistant",        "content": "1. Café Bleu Jasmin\n2. Dar Nour\n3. Les Terrasses du Cap"      }    }  ],  "usage": {    "prompt_tokens": 31,    "completion_tokens": 22,    "total_tokens": 53  }}

Vérifiez le coût

La facturation a lieu juste après l'envoi de la réponse. Quelques secondes plus tard, retrouvez la requête grâce à son id pour voir les tokens consommés et le montant déduit de votre solde en TND (native_cost.total).

curl "https://promptix.tn/api/v1/generation?id=gen-1758880023-kQ3vX8mZpL2nR7tW" \  -H "Authorization: Bearer $PROMPTIX_API_KEY"
200 OKJSON
{  "data": {    "id": "gen-1758880023-kQ3vX8mZpL2nR7tW",    "model": "openai/gpt-6-luna",    "created_at": "2026-09-26T09:47:03.512Z",    "usage": {      "prompt_tokens": 31,      "completion_tokens": 22,      "total_tokens": 53    },    "native_cost": {      "prompt": 0.0000404,      "completion": 0.0000287,      "total": 0.0000691    },    "total_cost": 0.00001785,    "metadata": {      "referrer": null,      "site_title": null    }  }}

Les mêmes informations figurent dans la page Utilisation de votre tableau de bord.

Et ensuite