OpenRouter

OpenRouter zapewnia ujednolicone API, które kieruje żądania do wielu modeli za jednym endpointem i kluczem API. Jest zgodne z OpenAI, więc większość SDK OpenAI działa po zmianie bazowego URL-a.

# Pierwsze kroki

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

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

# Przykład konfiguracji

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

# Odwołania do modeli

Przykłady dołączonych opcji awaryjnych:

# Generowanie obrazów

OpenRouter może także obsługiwać narzędzie image_generate. Użyj modelu obrazów OpenRouter w 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 wysyła żądania obrazów do API obrazów chat completions OpenRouter z modalities: ["image", "text"]. Modele obrazów Gemini otrzymują obsługiwane wskazówki aspectRatio i resolution przez image_config OpenRouter. Użyj agents.defaults.imageGenerationModel.timeoutMs dla wolniejszych modeli obrazów OpenRouter; parametr timeoutMs dla pojedynczego wywołania narzędzia image_generate nadal ma pierwszeństwo.

# Generowanie wideo

OpenRouter może także obsługiwać narzędzie video_generate przez swoje asynchroniczne API /videos. Użyj modelu wideo OpenRouter w agents.defaults.videoGenerationModel:

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

OpenClaw przesyła zadania text-to-video i image-to-video do OpenRouter, odpytuje zwrócony polling_url i pobiera ukończone wideo z unsigned_urls OpenRouter albo z udokumentowanego endpointu treści zadania. Obrazy referencyjne są domyślnie wysyłane jako obrazy pierwszej/ostatniej klatki; obrazy oznaczone reference_image są wysyłane jako referencje wejściowe OpenRouter. Dołączony domyślny google/veo-3.1-fast deklaruje obecnie obsługiwane czasy trwania 4/6/8 sekund, rozdzielczości 720P/1080P oraz proporcje obrazu 16:9/9:16. Video-to-video nie jest zarejestrowane dla OpenRouter, ponieważ nadrzędne API generowania wideo obecnie akceptuje tekst i referencje obrazów.

# Zamiana tekstu na mowę

OpenRouter może być także używany jako dostawca TTS przez zgodny z OpenAI endpoint /audio/speech.

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

Jeśli messages.tts.providers.openrouter.apiKey zostanie pominięte, TTS ponownie użyje models.providers.openrouter.apiKey, a następnie OPENROUTER_API_KEY.

# Uwierzytelnianie i nagłówki

OpenRouter używa pod spodem tokena Bearer z Twoim kluczem API.

W rzeczywistych żądaniach OpenRouter (https://openrouter.ai/api/v1) OpenClaw dodaje także udokumentowane nagłówki atrybucji aplikacji OpenRouter:

# Konfiguracja zaawansowana

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

# Powiązane