OpenRouter

OpenRouter มี API แบบรวมศูนย์ ที่กำหนดเส้นทางคำขอไปยังโมเดลจำนวนมากผ่าน endpoint และคีย์ API เดียว โดยเข้ากันได้กับ OpenAI ดังนั้น SDK ของ OpenAI ส่วนใหญ่จึงใช้งานได้ด้วยการเปลี่ยน base 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" },
    },
  },
}

# การอ้างอิงโมเดล

ตัวอย่าง fallback ที่รวมมาให้:

# การสร้างรูปภาพ

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 ส่งคำขอรูปภาพไปยัง API รูปภาพของ chat completions ของ OpenRouter ด้วย 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, poll 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 เพราะ API การสร้างวิดีโอต้นทางปัจจุบันรับข้อความและรูปภาพอ้างอิง

# Text-to-speech

OpenRouter ยังสามารถใช้เป็นผู้ให้บริการ TTS ผ่าน endpoint /audio/speech ที่เข้ากันได้กับ OpenAI ได้ด้วย

{
  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

# การยืนยันตัวตนและ headers

OpenRouter ใช้ Bearer token กับคีย์ API ของคุณอยู่ภายใน

ในคำขอ OpenRouter จริง (https://openrouter.ai/api/v1) OpenClaw จะเพิ่ม headers การระบุแอปตามที่ OpenRouter จัดทำเอกสารไว้ด้วย:

# การกำหนดค่าขั้นสูง

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

# ที่เกี่ยวข้อง