OpenRouter

OpenRouter يوفر واجهة API موحّدة توجه الطلبات إلى العديد من النماذج خلف نقطة نهاية واحدة ومفتاح 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 طلبات الصور إلى واجهة API لصور إكمالات المحادثة في 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 مهام تحويل النص إلى فيديو وتحويل الصورة إلى فيديو إلى OpenRouter، ويستطلع polling_url المُعاد، وينزّل الفيديو المكتمل من unsigned_urls في OpenRouter أو من نقطة نهاية محتوى المهمة الموثقة. تُرسل الصور المرجعية كصور للإطار الأول/الأخير افتراضيًا؛ وتُرسل الصور الموسومة بـ reference_image كمراجع إدخال في OpenRouter. يعلن الإعداد الافتراضي المضمن google/veo-3.1-fast عن مدد الثواني 4/6/8 المدعومة حاليًا، ودقات 720P/1080P، ونسب الأبعاد 16:9/9:16. لا يتم تسجيل تحويل الفيديو إلى فيديو لـ OpenRouter لأن واجهة API لتوليد الفيديو في المصدر تقبل حاليًا النص ومراجع الصور.

# تحويل النص إلى كلام

يمكن أيضًا استخدام OpenRouter كموفر TTS من خلال نقطة النهاية المتوافقة مع OpenAI /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 مع مفتاح API الخاص بك داخليًا.

في طلبات OpenRouter الحقيقية (https://openrouter.ai/api/v1)، يضيف OpenClaw أيضًا ترويسات إسناد التطبيق الموثقة لدى OpenRouter:

# الإعدادات المتقدمة

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

# ذات صلة