Démarrer

Votre SDK, relié à Renio.

Gardez les formats de votre fournisseur. Configurez l’adresse Renio et l’authentification de votre SDK avec un accès re_, suivant les exemples ci-dessous. Le coffre pose ensuite la vraie clé du fournisseur pour vous.

La règle, en une phrase

Renio vous reconnaît uniquement à votre accès re_ placé dans l’en-tête Authorization: Bearer. Pour OpenAI, Mistral et OpenRouter, c’est déjà l’en-tête natif : régler la clé du SDK sur votre re_ suffit. Pour Anthropic et Gemini (qui utilisent normalement x-api-key / x-goog-api-key), forcez l’en-tête Authorization — le proxy remet l’authentification native attendue par le fournisseur.

Dans les exemples ci-dessous, re_xxxxxxxxxxxxxxxxxxxx est un exemple — remplacez-le par le secret de votre accès, affiché une seule fois à sa création.

OpenAI

https://api.renio.ai/openai/v1/chat/completions

curl https://api.renio.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer re_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","max_tokens":256,"messages":[{"role":"user","content":"Bonjour"}]}'

SDK — SDK OpenAI : réglez api_key sur votre clé re_ et base_url sur l’URL ci-dessus (sans le suffixe de route).

Anthropic (Claude)

https://api.renio.ai/anthropic/v1/messages

curl https://api.renio.ai/anthropic/v1/messages \
  -H "Authorization: Bearer re_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Bonjour"}]}'

SDK — SDK Anthropic : la clé va normalement dans x-api-key ; ici, envoyez plutôt votre re_ en Authorization: Bearer (option authToken du SDK, ou defaultHeaders). Le proxy pose x-api-key et anthropic-version pour vous.

Mistral

https://api.renio.ai/mistral/v1/chat/completions

curl https://api.renio.ai/mistral/v1/chat/completions \
  -H "Authorization: Bearer re_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"mistral-large-latest","max_tokens":256,"messages":[{"role":"user","content":"Bonjour"}]}'

SDK — Authentification Bearer native : réglez la clé du SDK sur votre re_.

OpenRouter

https://api.renio.ai/openrouter/api/v1/chat/completions

curl https://api.renio.ai/openrouter/api/v1/chat/completions \
  -H "Authorization: Bearer re_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-4o","max_tokens":256,"messages":[{"role":"user","content":"Bonjour"}]}'

SDK — Authentification Bearer native : réglez la clé du SDK sur votre re_. Le coût exact renvoyé par OpenRouter fait foi pour vos budgets.

Gemini (Google)

https://api.renio.ai/gemini/v1beta/models/gemini-2.5-pro:generateContent

curl https://api.renio.ai/gemini/v1beta/models/gemini-2.5-pro:generateContent \
  -H "Authorization: Bearer re_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Bonjour"}]}],"generationConfig":{"maxOutputTokens":256}}'

SDK — La clé Gemini va normalement dans x-goog-api-key ou ?key= ; ici, envoyez votre re_ en Authorization: Bearer (le proxy retire tout ?key= de l’URL et pose x-goog-api-key pour vous).

Ce qu’on préfère vous dire

Accès plafonnés — Indiquez une limite de sortie dans chaque génération : max_tokens, max_completion_tokens, max_output_tokens ou generationConfig.maxOutputTokens, selon votre fournisseur. Les exemples ci-dessus en contiennent une. Un modèle non tarifé, plusieurs générations simultanées ou un contenu distant dont le coût ne peut pas être estimé sont refusés en HTTP 422 avec budget_measurement_unavailable. Ce contrôle concerne les accès avec un plafond de dépense.
Compteur indisponible — Les nouveaux appels contrôlés sont refusés en HTTP 503 avec budget_unavailable. Un appel déjà transmis au fournisseur peut rester facturé, même si son flux est interrompu.
Mistral en streaming — L’usage peut ne pas remonter dans le flux ; dans ce cas le coût est marqué « non mesuré » plutôt qu’inventé.
OpenRouter — Le coût exact renvoyé par OpenRouter fait foi pour vos budgets. Couper un flux n’arrête pas toujours la facturation amont.
Images, audio et outils hébergés — Leur coût n’est pas suffisamment estimable pour les accès plafonnés. Pour un accès sans plafond, la mesure dépend de l’adaptateur ; le tarif texte peut notamment être appliqué à l’usage audio Gemini. Le relevé ne remplace pas la facture du fournisseur.