Documentation VerzaRoute

VerzaRoute expose une API compatible avec le format OpenAI /chat/completions. Si tu utilises déjà un SDK OpenAI, il te suffit de changer la base URL et la clé API pour router tes appels vers n'importe lequel des modèles disponibles sur la plateforme.

curl https://verzaroute.com/api/v1/chat/completions \
  -H "Authorization: Bearer vzr_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Bonjour !"}]
  }'

Authentification

Chaque requête doit inclure ta clé API dans l'en-tête Authorization, au format Bearer vzr_sk_.... Génère ta clé depuis ton dashboard → Clés API. Ta clé n'est affichée qu'une seule fois à sa création — conserve-la en lieu sûr.

Endpoint de chat

POST /api/v1/chat/completions accepte les paramètres suivants :

Fichiers (images, documents)

Le champ content d'un message accepte soit une simple chaîne de texte, soit un tableau de blocs pour joindre des images et documents à ta requête :

curl https://verzaroute.com/api/v1/chat/completions \
  -H "Authorization: Bearer vzr_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{
      "role": "user",
      "content": [
        { "type": "text", "text": "Décris cette image" },
        { "type": "image", "base64": "<base64_sans_prefixe>", "mimeType": "image/png" }
      ]
    }]
  }'

Génération d'image

POST /api/v1/images/generations génère une image à partir d'un prompt texte, avec un modèle dédié à la génération d'image (distinct des modèles de chat).

curl https://verzaroute.com/api/v1/images/generations \
  -H "Authorization: Bearer vzr_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "Un lion doré au coucher du soleil, style peinture à l'huile",
    "size": "1024x1024"
  }'

La réponse contient l'image encodée en base64 :

{
  "created": 1720000000,
  "data": [{ "b64_json": "..." }],
  "verzaroute": { "credits_charged": 4 }
}

Contrairement au chat (facturé au token), la génération d'image est facturée à un forfait fixe par image, propre à chaque modèle. Consulte ton dashboard → Modèles pour voir les modèles de génération d'image disponibles et leur prix.

Modèles disponibles

La liste complète et à jour des modèles (avec prix et description) est consultable en temps réel depuis ton dashboard → Modèles. 10 fournisseurs sont supportés : OpenAI, Anthropic, Google, xAI, DeepSeek, Mistral AI, Moonshot AI (Kimi), MiniMax, Z.ai et StepFun.

Facturation & crédits

Chaque appel de chat débite ton solde en fonction des tokens réellement consommés (entrée + sortie), au coût du fournisseur majoré d'une marge de service. Chaque génération d'image débite un forfait fixe par image. Le coût exact de chaque appel est renvoyé dans la réponse, champ verzaroute.credits_charged.

Gestion des erreurs