OpenRouter

OpenRouter cung cấp một API hợp nhất định tuyến yêu cầu đến nhiều mô hình phía sau một endpoint và khóa API duy nhất. API này tương thích với OpenAI, nên hầu hết SDK OpenAI hoạt động bằng cách chuyển base URL.

# Bắt đầu

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

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

# Ví dụ cấu hình

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

# Tham chiếu mô hình

Ví dụ dự phòng đi kèm:

# Tạo hình ảnh

OpenRouter cũng có thể hỗ trợ công cụ image_generate. Dùng một mô hình hình ảnh OpenRouter trong 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 gửi yêu cầu hình ảnh đến API hình ảnh chat completions của OpenRouter với modalities: ["image", "text"]. Các mô hình hình ảnh Gemini nhận gợi ý aspectRatio và resolution được hỗ trợ thông qua image_config của OpenRouter. Dùng agents.defaults.imageGenerationModel.timeoutMs cho các mô hình hình ảnh OpenRouter chậm hơn; tham số timeoutMs theo từng lệnh gọi của công cụ image_generate vẫn được ưu tiên.

# Tạo video

OpenRouter cũng có thể hỗ trợ công cụ video_generate thông qua API /videos bất đồng bộ của nó. Dùng một mô hình video OpenRouter trong agents.defaults.videoGenerationModel:

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

OpenClaw gửi tác vụ text-to-video và image-to-video đến OpenRouter, thăm dò polling_url được trả về, rồi tải xuống video hoàn tất từ unsigned_urls của OpenRouter hoặc endpoint nội dung tác vụ được tài liệu hóa. Theo mặc định, hình ảnh tham chiếu được gửi dưới dạng hình ảnh khung đầu/cuối; hình ảnh được gắn thẻ reference_image được gửi dưới dạng tham chiếu đầu vào của OpenRouter. Mặc định google/veo-3.1-fast đi kèm công bố các thời lượng 4/6/8 giây hiện được hỗ trợ, độ phân giải 720P/1080P, và tỷ lệ khung hình 16:9/9:16. Video-to-video không được đăng ký cho OpenRouter vì API tạo video upstream hiện chấp nhận tham chiếu văn bản và hình ảnh.

# Text-to-speech

OpenRouter cũng có thể được dùng làm nhà cung cấp TTS thông qua endpoint /audio/speech tương thích với OpenAI.

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

Nếu bỏ qua messages.tts.providers.openrouter.apiKey, TTS sẽ tái sử dụng models.providers.openrouter.apiKey, rồi đến OPENROUTER_API_KEY.

# Xác thực và header

OpenRouter sử dụng Bearer token với khóa API của bạn ở bên dưới.

Trên các yêu cầu OpenRouter thực (https://openrouter.ai/api/v1), OpenClaw cũng thêm các header ghi nhận ứng dụng được OpenRouter tài liệu hóa:

# Cấu hình nâng cao

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

# Liên quan