OpenRouter

OpenRouter یک API یکپارچه ارائه می‌کند که درخواست‌ها را به مدل‌های زیادی پشت یک نقطهٔ پایانی و کلید API واحد مسیریابی می‌کند. با OpenAI سازگار است، بنابراین بیشتر SDKهای OpenAI با تغییر 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 درخواست‌های تصویر را با modalities: ["image", "text"] به API تصویر تکمیل‌های گفت‌وگوی OpenRouter می‌فرستد. مدل‌های تصویر Gemini راهنمایی‌های پشتیبانی‌شدهٔ aspectRatio و resolution را از طریق image_config در OpenRouter دریافت می‌کنند. برای مدل‌های تصویر کندتر OpenRouter از agents.defaults.imageGenerationModel.timeoutMs استفاده کنید؛ پارامتر timeoutMs در هر فراخوانی ابزار image_generate همچنان اولویت دارد.

# تولید ویدیو

OpenRouter همچنین می‌تواند از طریق API ناهمگام /videos خود پشتوانهٔ ابزار video_generate باشد. از یک مدل ویدیوی OpenRouter زیر agents.defaults.videoGenerationModel استفاده کنید:

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

OpenClaw کارهای متن‌به‌ویدیو و تصویر‌به‌ویدیو را به OpenRouter ارسال می‌کند، polling_url برگشتی را نظرسنجی می‌کند، و ویدیوی تکمیل‌شده را از unsigned_urls متعلق به OpenRouter یا نقطهٔ پایانی مستندشدهٔ محتوای کار دانلود می‌کند. تصویرهای مرجع به‌صورت پیش‌فرض به‌عنوان تصویرهای فریم اول/آخر فرستاده می‌شوند؛ تصویرهایی که با reference_image برچسب‌گذاری شده‌اند به‌عنوان ارجاع‌های ورودی OpenRouter ارسال می‌شوند. پیش‌فرض همراه google/veo-3.1-fast مدت‌های ۴/۶/۸ ثانیه‌ای، وضوح‌های 720P/1080P و نسبت‌های تصویر 16:9/9:16 را که در حال حاضر پشتیبانی می‌شوند اعلام می‌کند. ویدیو‌به‌ویدیو برای OpenRouter ثبت نشده است، زیرا API بالادستی تولید ویدیو در حال حاضر متن و ارجاع‌های تصویری را می‌پذیرد.

# متن‌به‌گفتار

OpenRouter همچنین می‌تواند از طریق نقطهٔ پایانی سازگار با OpenAI یعنی /audio/speech به‌عنوان ارائه‌دهندهٔ TTS استفاده شود.

{
  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 همراه با کلید API شما استفاده می‌کند.

در درخواست‌های واقعی OpenRouter (https://openrouter.ai/api/v1)، OpenClaw همچنین سرآیندهای مستندشدهٔ OpenRouter برای انتساب برنامه را اضافه می‌کند:

# پیکربندی پیشرفته

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

# مرتبط