Menu des Docs

Référence de l’API

v1· Mis à jour en juil. 2026

160+ modèles · 12 familles de modèles

WayJet est une passerelle compatible avec OpenAI. Pointez n’importe quel SDK OpenAI vers l’URL de base ci-dessous, utilisez une clé d’API sk- et appelez tous les fournisseurs à travers une seule API.

12 familles de modèles

OpenAI, Anthropic, Gemini, Groq et d’autres, derrière une seule API.

Compatible OpenAI

Pointez n’importe quel SDK OpenAI vers l’URL de base, sans changer votre code.

Streaming

SSE token par token sur chat completions, prêt à l’emploi.

Clés et budgets

Clés à portée limitée, plafonds de dépense par période et suivi de l’usage.

Appelez GET /v1/models avec votre clé pour lister les modèles que la passerelle vous sert.

Introduction#

Toutes les requêtes vont vers une seule URL de base. Comme la passerelle parle le format d’OpenAI, vos SDK et outils fonctionnent sans changement : vous ne remplacez que l’URL de base et la clé.

https://api.wayjet.ai/v1

Authentification#

Authentifiez-vous avec un jeton Bearer dans l’en-tête Authorization. Créez une clé préfixée par sk- sur la page Clés d’API : le secret n’est affiché qu’une fois, conservez-le en lieu sûr.

header
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
N’exposez jamais une clé dans du code côté client. Appelez la passerelle depuis votre serveur, ou passez par un proxy.
Créer une clé d’API

Démarrage rapide#

Envoyez votre premier chat completion. Définissez WAYJET_API_KEY avec votre clé d’API et lancez-le tel quel, ou remplacez gpt-5.1 par n’importe quel identifiant de modèle de GET /v1/models, qui liste les modèles que votre clé peut appeler.

curl https://api.wayjet.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
L’essayer dans le Playground

Chat completions#

POST /v1/chat/completions : le point de terminaison principal. Les requêtes et réponses suivent le schéma d’OpenAI ; la passerelle ajoute provider et cache_status à la réponse.

ParamètreTypeDescription
model*stringUn identifiant de modèle de GET /v1/models (gpt-5.1 dans les exemples)
messages*arrayMessages de la conversation (role + content)
streambooleanRenvoie les tokens en server-sent events
temperaturenumberTempérature d’échantillonnage, 0–2 (1 par défaut)
max_tokensintegerNombre maximal de tokens à générer
top_pnumberMasse de probabilité de l’échantillonnage nucleus
toolsarrayDéfinitions de fonctions/outils que le modèle peut appeler
tool_choicestring | objectImpose ou restreint le choix d’outil
response_formatobjectp. ex. { "type": "json_object" } pour le mode JSON
reasoning_effortstringlow · medium · high (modèles de raisonnement)
stopstring | arrayJusqu’à 4 séquences d’arrêt
seedintegerÉchantillonnage déterministe dans la mesure du possible
providerstringPropre à la passerelle : fixe la requête sur un fournisseur

* obligatoire

Streaming#

Indiquez stream: true pour recevoir les tokens en server-sent events. Chaque événement est une ligne data: portant un delta ; le flux se termine par data: [DONE].

curl https://api.wayjet.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'
# → server-sent events: lines of  data: {...}  terminated by  data: [DONE]

Cache des prompts#

Plusieurs fournisseurs mettent en cache le début d’un prompt vu récemment et facturent moins pour le retraiter. Chez OpenAI, Gemini et DeepSeek, c’est automatique : aucun paramètre n’est nécessaire, et ni vous ni WayJet ne pouvez le désactiver. Anthropic ne met en cache que lorsque la requête le demande.

Avec la clé de la plateforme, WayJet ne respecte `cache_control` que pour les comptes rattachés à leur propre espace de travail Anthropic. Sinon, le marqueur est accepté puis retiré avant que la requête n’atteigne Anthropic. L’appel réussit quand même, mais son usage ne contient aucun token de cache et chaque token d’entrée est facturé au tarif d’entrée plein, ce qu’Anthropic facture aussi. Avec votre propre clé Anthropic, le marqueur passe toujours.

Chaque fournisseur trace la limite du cache au niveau de son propre client. Avec une clé de la plateforme WayJet, ce client est WayJet : chez les trois fournisseurs automatiques, vos requêtes partagent donc un espace de cache avec d’autres comptes WayJet pendant la fenêtre de réutilisation ci-dessous. La passerelle renvoie cache_status sur chat completions, mais cela indique si un préfixe a été réutilisé, pas à qui il appartenait.

FournisseurCacheLimite du cacheFenêtre de réutilisation
OpenAIAutomatiqueL’organisation : celle de WayJet, avec la clé de la plateformejusqu’à 30 min
GeminiAutomatiqueLe projet Google Cloud : celui de WayJet, avec la clé de la plateformejusqu’à 24 h
DeepSeekAutomatiqueLe compte : celui de WayJet, avec la clé de la plateformede quelques heures à quelques jours
AnthropicSur demande (cache_control), avec votre propre clé ou un compte rattachéVotre propre compte (BYOK) ou votre espace de travail rattaché5 min
Claude sur Bedrock / VertexSur demande, identifiants propres uniquementLe compte AWS / le projet GCP5 min

Ce qu’un cache partagé signifie, et ce qu’il ne signifie pas

Aucun contenu de prompt ou de réponse ne traverse un cache de prompts. Un succès de cache, c’est le fournisseur qui retraite à moindre coût un préfixe que l’appelant a lui-même envoyé : il ne transmet le texte de personne à personne. Ce qu’un espace partagé expose, c’est le temps : quelqu’un qui détient déjà un préfixe exact pourrait, en théorie, déduire d’une réponse plus rapide ou moins chère qu’il a été envoyé récemment. Il doit d’abord connaître ce préfixe, ce qui borne le risque.

Nous le publions parce que vous ne pouvez pas l’observer vous-même. WayJet masque volontairement quel fournisseur a traité une requête : rien dans l’API ni dans le tableau de bord ne vous dirait où passe la limite du cache d’un fournisseur. Si vous revendez de l’inférence à vos propres utilisateurs, voici la réponse à la même question, un niveau plus bas.

Si vous avez besoin de votre propre espace de cache

Deux voies, et ce sont les seules honnêtes : aucun réglage par client sur la clé de la plateforme ne permet de le faire.

  • Utilisez votre propre clé. Ajoutez vos propres identifiants de fournisseur : votre trafic passe alors par votre compte chez le fournisseur, et la limite du cache est tracée autour de vous. Cela fonctionne avec tous les fournisseurs et répond entièrement au besoin.
  • Demandez un espace de travail Anthropic. Pour Anthropic seulement, nous pouvons rattacher votre compte à son propre espace de travail Anthropic : votre cache de prompts n’appartient alors qu’à vous, tout en continuant à utiliser la clé de la plateforme. C’est sur demande et activé compte par compte : il n’y a pas d’interrupteur en libre-service, et cela ne s’applique pas à Claude via Bedrock ou Vertex, qui n’ont pas d’équivalent. C’est aussi ce qui active le cache Anthropic pour un compte sur la clé de la plateforme.

Embeddings#

POST /v1/embeddings : vectorise du texte pour la recherche et le RAG. Accepte une chaîne ou un tableau de chaînes.

curl https://api.wayjet.ai/v1/embeddings \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model",
    "input": "The quick brown fox"
  }'

Audio (voix)#

POST /v1/audio/speech transforme du texte en voix (facturé au caractère en entrée), et POST /v1/audio/transcriptions transforme un fichier audio en texte (facturé à la minute d’audio). Les deux sont compatibles avec OpenAI.

Synthèse vocale

curl https://api.wayjet.ai/v1/audio/speech \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-tts-model",
    "input": "The quick brown fox jumped over the lazy dog.",
    "voice": "alloy"
  }' \
  --output speech.mp3

Transcription

Envoyez le fichier en multipart/form-data. Indiquez srt, vtt ou verbose_json dans response_format pour obtenir des sous-titres horodatés plutôt que du texte brut.

curl https://api.wayjet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -F "model=your-stt-model" \
  -F "file=@audio.mp3" \
  -F "response_format=json"   # json (default) · text · srt · vtt · verbose_json

Modèles#

GET /v1/models renvoie le catalogue disponible pour votre clé, chaque modèle avec ses prix et ses capacités. Utilisez un id de cette liste comme model dans tous les exemples de cette page.

shell
curl https://api.wayjet.ai/v1/models \
  -H "Authorization: Bearer $WAYJET_API_KEY"
Voir tous les modèles

Outils CLI (Claude Code, Codex)#

La passerelle parle l’API Messages d’Anthropic (POST /v1/messages) et l’API Responses d’OpenAI (POST /v1/responses) : les CLI de développement les plus utilisées pointent donc directement vers WayJet et sont facturées sur votre propre clé, sans proxy ni SDK propre à chaque fournisseur. Pointez chaque outil vers un modèle que vous pouvez appeler.

Qu’est-ce qu’un squad ?

Un squad est un nom de modèle que vous appelez : un produit nommé de la passerelle, qui répond sous son propre nom. Utilisez un nom de squad partout où un nom de modèle est attendu. GET /v1/models liste ceux que votre clé peut appeler. Les noms de modèle des configurations ci-dessous sont des squads : ils fonctionnent tels quels.

Claude Code

Ajoutez à ~/.claude/settings.json. La clé passe par ANTHROPIC_AUTH_TOKEN (ou par ANTHROPIC_API_KEY comme en-tête x-api-key), et chaque niveau correspond au modèle de votre choix.

~/.claude/settings.json
{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wayjet.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Codex

Codex utilise par défaut l’API Responses d’OpenAI : aucun wire_api = "chat" n’est nécessaire.

~/.codex/config.toml
model = "gpt-5.1"
model_provider = "wayjet"

[model_providers.wayjet]
name = "WayJet"
base_url = "https://api.wayjet.ai/v1"
wire_api = "responses"
~/.codex/auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-key"
}

Claude Code et Codex envoient chaque requête au seul modèle qu’ils nomment.

Erreurs#

Les erreurs utilisent les codes d’état HTTP standard et une enveloppe au format OpenAI.

json
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
StatutTypeSignification
200OKLa requête a abouti
400invalid_request_errorRequête mal formée ou paramètres invalides
401authentication_errorClé d’API absente, invalide ou révoquée
403permission_errorLa clé n’est pas autorisée à faire cette action
404not_found_errorModèle ou ressource inconnu
429rate_limit_errorLimite de débit atteinte, ou budget dépassé
500api_errorErreur inattendue de la passerelle
Voir votre usage et vos limites

Points de terminaison#

Les points de terminaison que vous pouvez appeler avec une clé d’API. Les clés, l’usage et les budgets se gèrent depuis le tableau de bord.

MéthodePoint de terminaisonDescription
POST/v1/chat/completionsChat completion (avec ou sans streaming)
POST/v1/messagesFormat Messages d’Anthropic (avec ou sans streaming ; x-api-key ou Bearer)
POST/v1/responsesFormat Responses d’OpenAI (avec ou sans streaming). Sans état : previous_response_id est ignoré, envoyez donc toute la conversation à chaque fois
GET/v1/generationCoût et tokens d’une requête, par son X-Wayjet-Request-Id (?id=)
POST/v1/embeddingsCréer des embeddings
POST/v1/audio/speechSynthèse vocale (sortie audio)
POST/v1/audio/transcriptionsTranscription de la voix en texte
GET/v1/modelsLister les modèles disponibles

Journal des modifications#

Les changements notables de l’API publique. L’URL de base reste /v1 par compatibilité.

  • juil. 2026Outils CLI : utilisez Claude Code (/v1/messages) et Codex (/v1/responses) directement. Statistiques de génération (/v1/generation).
  • juil. 2026Audio : synthèse vocale (/v1/audio/speech) et transcription (/v1/audio/transcriptions, aux formats srt/vtt/verbose_json).
  • juin 2026Ajout de reasoning_effort.
  • mai 2026Point de terminaison d’embeddings et mode JSON (response_format).
  • avr. 2026Streaming (SSE) sur chat completions ; épinglage du fournisseur.
Journal complet