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 HTTP | Chemin complet | Famille de protocoles | Fonction |
|---|---|---|---|
HTTP GET | api.quantarelay.com/v1/models | OpenAI | Liste les modèles appelables sauf Gemini; nécessite une clé; gratuit |
HTTP POST | api.quantarelay.com/v1/chat/completions | OpenAI | Complétions de chat, streaming pris en charge |
HTTP POST | api.quantarelay.com/v1/responses | OpenAI | API Responses, streaming pris en charge |
HTTP POST | api.quantarelay.com/v1/messages | Anthropic | API Messages, streaming pris en charge |
HTTP POST | api.quantarelay.com/v1/messages/count_tokens | Anthropic | Compte les tokens; jamais facturé |
HTTP GET | api.quantarelay.com/v1beta/models | Gemini | Liste les modèles Gemini; clé requise; gratuit |
HTTP POST | api.quantarelay.com/v1beta/models/{model}:generateContent | Gemini | Renvoie la réponse complète en une seule fois |
HTTP POST | api.quantarelay.com/v1beta/models/{model}:streamGenerateContent?alt=sse | Gemini | Diffuse la réponse en SSE |
HTTP POST | api.quantarelay.com/v1beta/models/{model}:countTokens | Gemini | Compte 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 type | Fonction |
|---|---|
400 · invalid_request_error | Modèle manquant ou inconnu, ou indisponible avec ce protocole |
401 · authentication_error | Clé manquante ou non reconnue |
402 · insufficient_quota | Solde épuisé — rechargez, puis réessayez |
403 · permission_error | Compte suspendu |
404 · not_found | Route introuvable |
413 · invalid_request_error | Corps de requête supérieur à 25 Mo |
429 · rate_limit_error | Limite de débit par clé ou de requêtes simultanées par compte atteinte |
502 · api_error | Fournisseur injoignable; aucun frais |
503 · api_error | Connexion 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-solgpt-6-astragpt-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
geminicurl "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-progemini-4-argongemini-3.8-flashgemini-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
claudeLes 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.