OpenRouter

OpenRouter надає уніфікований API, який маршрутизує запити до багатьох моделей за одним endpoint і API-ключем. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють після перемикання базового URL.

# Початок роботи

openclaw onboard --auth-choice openrouter-api-key

openclaw models set openrouter/<provider>/<model>

# Приклад конфігурації

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/auto" },
    },
  },
}

# Посилання на моделі

Приклади вбудованого резервного варіанта:

# Генерація зображень

OpenRouter також може забезпечувати роботу інструмента image_generate. Використовуйте модель зображень OpenRouter у agents.defaults.imageGenerationModel:

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "openrouter/google/gemini-3.1-flash-image-preview",
        timeoutMs: 180_000,
      },
    },
  },
}

OpenClaw надсилає запити зображень до OpenRouter chat completions image API з modalities: ["image", "text"]. Моделі зображень Gemini отримують підтримувані підказки aspectRatio і resolution через image_config OpenRouter. Використовуйте agents.defaults.imageGenerationModel.timeoutMs для повільніших моделей зображень OpenRouter; параметр timeoutMs інструмента image_generate для окремого виклику все одно має пріоритет.

# Генерація відео

OpenRouter також може забезпечувати роботу інструмента video_generate через свій асинхронний API /videos. Використовуйте модель відео OpenRouter у agents.defaults.videoGenerationModel:

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "openrouter/google/veo-3.1-fast",
      },
    },
  },
}

OpenClaw надсилає завдання text-to-video та image-to-video до OpenRouter, опитує повернений polling_url і завантажує завершене відео з unsigned_urls OpenRouter або задокументованого endpoint вмісту завдання. Еталонні зображення типово надсилаються як зображення першого/останнього кадру; зображення, позначені reference_image, надсилаються як вхідні посилання OpenRouter. Вбудоване типове значення google/veo-3.1-fast оголошує поточно підтримувані тривалості 4/6/8 секунд, роздільності 720P/1080P і співвідношення сторін 16:9/9:16. Video-to-video не зареєстровано для OpenRouter, тому що upstream API генерації відео наразі приймає текст і посилання на зображення.

# Перетворення тексту на мовлення

OpenRouter також можна використовувати як провайдера TTS через його сумісний з OpenAI endpoint /audio/speech.

{
  messages: {
    tts: {
      auto: "always",
      provider: "openrouter",
      providers: {
        openrouter: {
          model: "hexgrad/kokoro-82m",
          voice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}

Якщо messages.tts.providers.openrouter.apiKey пропущено, TTS повторно використовує models.providers.openrouter.apiKey, а потім OPENROUTER_API_KEY.

# Автентифікація та заголовки

OpenRouter використовує Bearer token із вашим API-ключем під капотом.

У реальних запитах OpenRouter (https://openrouter.ai/api/v1) OpenClaw також додає задокументовані заголовки атрибуції застосунку OpenRouter:

# Розширена конфігурація

{
  agents: {
    defaults: {
      models: {
        "openrouter/auto": {
          params: {
            responseCache: true,
            responseCacheTtlSeconds: 300,
          },
        },
      },
    },
  },
}

# Пов’язане