--- read_when: - Vous souhaitez une seule clé API pour de nombreux LLM - Vous souhaitez exécuter des modèles via OpenRouter dans OpenClaw - Vous souhaitez utiliser OpenRouter pour la génération d’images - Vous souhaitez utiliser OpenRouter pour la génération de vidéos summary: Utilisez l’API unifiée d’OpenRouter pour accéder à de nombreux modèles dans OpenClaw title: OpenRouter x-i18n: generated_at: "2026-05-12T08:45:53Z" model: gpt-5.5 provider: openai source_hash: 0dbf2b5a69636eb18471dd7d1dcf05ee30da931e2e3b5c9ae5d44a20d3e46f78 source_path: providers/openrouter.md workflow: 16 --- OpenRouter fournit une **API unifiée** qui achemine les requêtes vers de nombreux modèles derrière un seul endpoint et une seule clé d’API. Elle est compatible avec OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant l’URL de base. ## Bien démarrer Créez une clé d’API sur [openrouter.ai/keys](https://openrouter.ai/keys). ```bash openclaw onboard --auth-choice openrouter-api-key ``` L’intégration initiale utilise `openrouter/auto` par défaut. Choisissez un modèle concret plus tard : ```bash openclaw models set openrouter// ``` ## Exemple de configuration ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { model: { primary: "openrouter/auto" }, }, }, } ``` ## Références de modèles Les références de modèles suivent le modèle `openrouter//`. Pour la liste complète des fournisseurs et modèles disponibles, consultez [/concepts/model-providers](/fr/concepts/model-providers). Exemples de secours inclus : | Référence de modèle | Notes | | -------------------------------- | --------------------------------- | | `openrouter/auto` | Routage automatique d’OpenRouter | | `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 via MoonshotAI | | `openrouter/moonshotai/kimi-k2.5` | Kimi K2.5 via MoonshotAI | ## Génération d’images OpenRouter peut aussi prendre en charge l’outil `image_generate`. Utilisez un modèle d’image OpenRouter sous `agents.defaults.imageGenerationModel` : ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { imageGenerationModel: { primary: "openrouter/google/gemini-3.1-flash-image-preview", timeoutMs: 180_000, }, }, }, } ``` OpenClaw envoie les requêtes d’image à l’API d’images des complétions de chat d’OpenRouter avec `modalities: ["image", "text"]`. Les modèles d’image Gemini reçoivent les indications `aspectRatio` et `resolution` prises en charge via `image_config` d’OpenRouter. Utilisez `agents.defaults.imageGenerationModel.timeoutMs` pour les modèles d’image OpenRouter plus lents ; le paramètre `timeoutMs` par appel de l’outil `image_generate` reste prioritaire. ## Génération de vidéos OpenRouter peut aussi prendre en charge l’outil `video_generate` via son API asynchrone `/videos`. Utilisez un modèle vidéo OpenRouter sous `agents.defaults.videoGenerationModel` : ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { videoGenerationModel: { primary: "openrouter/google/veo-3.1-fast", }, }, }, } ``` OpenClaw soumet à OpenRouter des tâches de texte vers vidéo et d’image vers vidéo, interroge le `polling_url` renvoyé, puis télécharge la vidéo terminée depuis les `unsigned_urls` d’OpenRouter ou l’endpoint documenté du contenu de la tâche. Les images de référence sont envoyées par défaut comme images de première/dernière image ; les images marquées avec `reference_image` sont envoyées comme références d’entrée OpenRouter. Le modèle par défaut inclus `google/veo-3.1-fast` annonce les durées actuellement prises en charge de 4/6/8 secondes, les résolutions `720P`/`1080P` et les formats d’image `16:9`/`9:16`. La vidéo vers vidéo n’est pas enregistrée pour OpenRouter, car l’API amont de génération vidéo accepte actuellement le texte et les références d’image. ## Texte vers parole OpenRouter peut aussi être utilisé comme fournisseur TTS via son endpoint compatible OpenAI `/audio/speech`. ```json5 { messages: { tts: { auto: "always", provider: "openrouter", providers: { openrouter: { model: "hexgrad/kokoro-82m", voice: "af_alloy", responseFormat: "mp3", }, }, }, }, } ``` Si `messages.tts.providers.openrouter.apiKey` est omis, TTS réutilise `models.providers.openrouter.apiKey`, puis `OPENROUTER_API_KEY`. ## Parole vers texte (audio entrant) OpenRouter peut transcrire les pièces jointes vocales/audio entrantes via le chemin partagé `tools.media.audio` en utilisant son endpoint STT (`/audio/transcriptions`). Cela s’applique à tout Plugin de canal qui transmet les contenus vocaux/audio entrants au précontrôle de compréhension des médias. ```json5 { tools: { media: { audio: { enabled: true, models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }], }, }, }, } ``` OpenClaw envoie les requêtes STT OpenRouter en JSON avec l’audio en base64 sous `input_audio` (contrat STT OpenRouter), et non sous forme d’envois de formulaire multipart OpenAI. ## Authentification et en-têtes OpenRouter utilise en interne un jeton Bearer avec votre clé d’API. Pour les requêtes OpenRouter réelles (`https://openrouter.ai/api/v1`), OpenClaw ajoute aussi les en-têtes documentés d’attribution d’application d’OpenRouter : | En-tête | Valeur | | ------------------------- | ------------------------------------------------------------------------------------------------------ | | `HTTP-Referer` | `https://openclaw.ai` | | `X-OpenRouter-Title` | `OpenClaw` | | `X-OpenRouter-Categories` | `cli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent` | Si vous redirigez le fournisseur OpenRouter vers un autre proxy ou une autre URL de base, OpenClaw n’injecte **pas** ces en-têtes propres à OpenRouter ni les marqueurs de cache Anthropic. ## Configuration avancée La mise en cache des réponses OpenRouter est facultative. Activez-la par modèle OpenRouter avec les paramètres de modèle : ```json5 { agents: { defaults: { models: { "openrouter/auto": { params: { responseCache: true, responseCacheTtlSeconds: 300, }, }, }, }, }, } ``` OpenClaw envoie `X-OpenRouter-Cache: true` et, lorsqu’il est configuré, `X-OpenRouter-Cache-TTL`. `responseCacheClear: true` force une actualisation pour la requête actuelle et stocke la réponse de remplacement. Les alias snake_case (`response_cache`, `response_cache_ttl_seconds` et `response_cache_clear`) sont également acceptés. Cette mise en cache est distincte de la mise en cache des prompts du fournisseur et des marqueurs Anthropic `cache_control` d’OpenRouter. Elle n’est appliquée que sur les routes `openrouter.ai` vérifiées, pas sur les URL de base de proxy personnalisées. Sur les routes OpenRouter vérifiées, les références de modèles Anthropic conservent les marqueurs Anthropic `cache_control` propres à OpenRouter qu’OpenClaw utilise pour une meilleure réutilisation du cache de prompts sur les blocs de prompts système/développeur. Sur les routes OpenRouter vérifiées, les références de modèles Anthropic avec le raisonnement activé suppriment les tours de préremplissage assistant finaux avant que la requête n’atteigne OpenRouter, conformément à l’exigence d’Anthropic selon laquelle les conversations de raisonnement se terminent par un tour utilisateur. Sur les routes non `auto` prises en charge, OpenClaw mappe le niveau de réflexion sélectionné vers les charges utiles de raisonnement du proxy OpenRouter. Les indications de modèles non prises en charge et `openrouter/auto` ignorent cette injection de raisonnement. Hunter Alpha ignore aussi le raisonnement proxy pour les références de modèles configurées obsolètes, car OpenRouter pourrait renvoyer le texte de réponse finale dans les champs de raisonnement pour cette route retirée. Sur les routes OpenRouter vérifiées, `openrouter/deepseek/deepseek-v4-flash` et `openrouter/deepseek/deepseek-v4-pro` complètent le `reasoning_content` manquant sur les tours assistant rejoués afin que les conversations de réflexion/outils conservent la forme de suivi requise par DeepSeek V4. OpenClaw envoie les valeurs `reasoning_effort` prises en charge par OpenRouter pour ces routes ; `xhigh` est le niveau annoncé le plus élevé, et les surcharges `max` obsolètes sont mappées vers `xhigh`. OpenRouter passe toujours par le chemin compatible OpenAI de style proxy, donc la mise en forme des requêtes native propre à OpenAI, comme `serviceTier`, Responses `store`, les charges utiles de compatibilité du raisonnement OpenAI et les indications de cache de prompts, n’est pas transmise. Les références OpenRouter adossées à Gemini restent sur le chemin proxy-Gemini : OpenClaw y conserve le nettoyage des signatures de réflexion Gemini, mais n’active pas la validation de relecture Gemini native ni les réécritures d’amorçage. Si vous transmettez le routage du fournisseur OpenRouter sous les paramètres de modèle, OpenClaw le transmet comme métadonnées de routage OpenRouter avant l’exécution des wrappers de flux partagés. ## Associé Choisir les fournisseurs, les références de modèles et le comportement de bascule. Référence complète de configuration pour les agents, modèles et fournisseurs.