Vos scripts, nos modèles.

Il faut un palier Pro ou Expert

La clé est incluse à partir de Pro. Un compte gratuit ou Starter reçoit 403 PREMIUM_REQUIRED, à la création comme à l'appel.

Les appels débitent VOTRE portefeuille

Chaque appel consomme des Vena Tokens sur le solde du propriétaire de la clé, aux mêmes multiplicateurs que le chat. Rien n'est facturé séparément.

Le secret ne s'affiche qu'une fois

Nous n'en stockons que l'empreinte : nous sommes techniquement incapables de vous la réafficher. Perdue, une clé se remplace par une rotation.

Une clé exposée est bornée, pas illimitée

Cadence par clé, coupe-circuit sur le volume et sur la dépense. Au-delà, la clé se désactive seule et vous recevez un e-mail.

La clé se présente dans l'en-tête HTTP Authorization, en schéma Bearer. Aucun autre canal n'est accepté.

Authorization: Bearer vena_sk_VOTRE_CLE

Le format d'entrée est celui des clients OpenAI : la plupart des SDK existants fonctionnent en changeant l'URL de base et la clé.

curl https://api.venalabs.example/api/ai/v1/chat/completions \
  -H "Authorization: Bearer vena_sk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vena-eco",
    "messages": [{"role": "user", "content": "Résume ce texte en trois points."}],
    "max_tokens": 500
  }'

Le bloc usage porte les tokens du MODÈLE (ceux que tout client OpenAI sait déjà lire) et, préfixés vena_, ce qui a réellement été prélevé sur votre portefeuille. Les deux nombres diffèrent d'un facteur 1 à 80 selon la classe : les confondre est ce qui produit une facture surprise.

{
  "id": "3f2a1c8e-…",
  "object": "chat.completion",
  "model": "vena-eco",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "…" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 412,
    "completion_tokens": 168,
    "total_tokens": 580,
    "vena_tokens_charged": 271,
    "vena_model_class": "ECO",
    "vena_multiplier": 1,
    "vena_balance_after": 7999729,
    "vena_usage_missing": false
  }
}

Avec stream à true, la réponse arrive en Server-Sent Events, au protocole des SDK OpenAI : des fragments data: sans nom d'événement, un fragment final portant finish_reason et le bloc usage complet, puis la sentinelle data: [DONE].

data: {"id":"3f2a…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant"}}]}

data: {"id":"3f2a…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Trois "}}]}

data: {"id":"3f2a…","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"vena_tokens_charged":271,"vena_balance_after":7999729}}

data: [DONE]

Votre solde borne la dépense totale, jamais le débit. Une clé publiée par erreur dans un dépôt Git respecterait parfaitement votre quota tout en le vidant en une nuit. Trois garde-fous s'en chargent.

Les erreurs sont au format VenaLabs, pas au format OpenAI : {code, message, details}. C'est délibéré — un refus pour solde insuffisant doit se distinguer sans ambiguïté d'un incident quelconque, et le format OpenAI ne connaît pas cette notion.

• Un seul choix par appel : le champ n n'est pas supporté.
• Ni outils, ni appels de fonctions, ni sorties structurées : le champ tools est ignoré.
• Ni images, ni fichiers en entrée : messages ne prend que du texte.
• Ni température, ni top_p : ces réglages ne sont pas exposés tant qu'ils ne sont pas honorés.
• Les identifiants de modèles sont des identifiants VenaLabs. Ils ne nomment pas de fournisseur.