Quanta

Connecter vos clients à Quanta

L’API dispose de son propre sous-domaine, api.quantarelay.com, distinct du site web. Chaque client est présenté ci-dessous.

Référence API

Tous les chemins ci-dessous sont accessibles sur https://api.quantarelay.com; les trois protocoles partagent une même clé et un même solde.

Liste des points de terminaison

Verbe HTTPChemin completFamille de protocolesFonction
HTTP GETapi.quantarelay.com/v1/modelsOpenAIListe les modèles appelables sauf Gemini; nécessite une clé; gratuit
HTTP POSTapi.quantarelay.com/v1/chat/completionsOpenAIComplétions de chat, streaming pris en charge
HTTP POSTapi.quantarelay.com/v1/responsesOpenAIAPI Responses, streaming pris en charge
HTTP POSTapi.quantarelay.com/v1/messagesAnthropicAPI Messages, streaming pris en charge
HTTP POSTapi.quantarelay.com/v1/messages/count_tokensAnthropicCompte les tokens; jamais facturé
HTTP GETapi.quantarelay.com/v1beta/modelsGeminiListe les modèles Gemini; clé requise; gratuit
HTTP POSTapi.quantarelay.com/v1beta/models/{model}:generateContentGeminiRenvoie la réponse complète en une seule fois
HTTP POSTapi.quantarelay.com/v1beta/models/{model}:streamGenerateContent?alt=sseGeminiDiffuse la réponse en SSE
HTTP POSTapi.quantarelay.com/v1beta/models/{model}:countTokensGeminiCompte les tokens; jamais facturé

En-têtes et authentification

  • Envoyez la clé dans Authorization: Bearer pour les routes OpenAI, x-api-key pour les routes Anthropic et x-goog-api-key pour les routes Gemini.
  • Si une requête Anthropic ne contient pas anthropic-version, Quanta ajoute 2023-06-01.
  • La clé peut aussi être transmise via le paramètre de requête ?key=, principalement pour les clients Gemini.
  • Votre adresse IP, vos cookies et les en-têtes CDN ne sont jamais transmis au fournisseur.

Limites et délais d’expiration

  • Par clé: jusqu’à 120 requêtes sur toute période de 60 secondes
  • Par compte: jusqu’à 8 requêtes simultanées
  • Corps de la requête: 25 Mo maximum
  • Par compte: jusqu’à 20 clés actives
  • Streaming: aucune limite de durée totale; seule une absence de données du fournisseur pendant 300 s met fin au flux

Format des erreurs et codes de statut

Les erreurs sont toujours renvoyées au format OpenAI:

{"error": {"message": "Your Quanta balance is used up. Top up from the dashboard to resume metered calls.", "type": "insufficient_quota", "code": 402}}
HTTP · Valeur de typeFonction
400 · invalid_request_errorModèle manquant ou inconnu, ou indisponible avec ce protocole
401 · authentication_errorClé manquante ou non reconnue
402 · insufficient_quotaSolde épuisé — rechargez, puis réessayez
403 · permission_errorCompte suspendu
404 · not_foundRoute introuvable
413 · invalid_request_errorCorps de requête supérieur à 25 Mo
429 · rate_limit_errorLimite de débit par clé ou de requêtes simultanées par compte atteinte
502 · api_errorFournisseur injoignable; aucun frais
503 · api_errorConnexion au fournisseur non configurée

Guides d’intégration

Après la présentation du protocole ci-dessus, voici la configuration pour chaque type de client.

SDK OpenAI, Codex et autres clients compatibles

Définissez base_url sur l'adresse de base suivie de /v1 et api_key sur votre clé. Le chat utilise /v1/chat/completions; l'API Responses est accessible via /v1/responses.

base_url = "https://api.quantarelay.com/v1"   # Quanta, OpenAI-compatible
api_key  = "qnt-your-key-here"

Python, avec le paquet officiel openai:

from openai import OpenAI  # pip install openai
qt = OpenAI(base_url="https://api.quantarelay.com/v1", api_key="qnt-your-key-here")
qt_reply = qt.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "user", "content": "Résume le journal des incidents de ce trimestre en trois points"}])
print(qt_reply.choices[0].message.content)
curl https://api.quantarelay.com/v1/chat/completions \
  -H "Authorization: Bearer qnt-your-key-here" -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"Résume le journal des incidents de ce trimestre en trois points"}]}'

Identifiants GPT conseillés pour commencer:

  • gpt-6.1-sol
  • gpt-6-astra
  • gpt-5.6-sol

Gemini CLI et l'API native Gemini

Définissez GOOGLE_GEMINI_BASE_URL sur l'hôte seul (sans ajouter /v1beta) et GEMINI_API_KEY sur votre clé, puis exécutez gemini.

export GOOGLE_GEMINI_BASE_URL=https://api.quantarelay.com
export GEMINI_API_KEY=qnt-your-key-here
gemini
curl "https://api.quantarelay.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: qnt-your-key-here" -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Liste trois façons de réduire les dépenses en tokens des traitements par lots"}]}]}'

Les modèles Gemini utilisent uniquement leur protocole natif: :generateContent pour une réponse unique, :streamGenerateContent?alt=sse pour le streaming. Ils ne sont pas accessibles via /v1/chat/completions.

Identifiants des modèles Gemini disponibles:

  • gemini-3.1-pro
  • gemini-4-argon
  • gemini-3.8-flash
  • gemini-2.5-flash

Claude Code et Claude Desktop

Définissez deux variables d’environnement, puis lancez claude : ANTHROPIC_BASE_URL indique l’adresse de base (sans /v1) et ANTHROPIC_AUTH_TOKEN contient votre clé.

export ANTHROPIC_BASE_URL=https://api.quantarelay.com
export ANTHROPIC_AUTH_TOKEN=qnt-your-key-here
claude

Les modèles Claude sont accessibles uniquement depuis les clients officiels Claude Code et Claude Desktop, et Claude Code doit être en version 2.1.285 ou ultérieure — une restriction du fournisseur en amont. GPT, Gemini et les autres modèles fonctionnent avec tout client ou SDK compatible.

S'inscrire