الانتقال إلى المحتوى الرئيسي
Qianfan هي منصة MaaS من Baidu، وتوفر API موحدًا يوجّه الطلبات إلى نماذج عديدة خلف نقطة نهاية واحدة ومفتاح API واحد. وهي متوافقة مع OpenAI، لذلك تعمل معظم OpenAI SDKs عند تبديل عنوان URL الأساسي.
الخاصيةالقيمة
المزوّدqianfan
المصادقةQIANFAN_API_KEY
APIمتوافق مع OpenAI
عنوان URL الأساسيhttps://qianfan.baidubce.com/v2

​
تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway: 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
البدء

1

إنشاء حساب Baidu Cloud

سجّل أو ادخل في وحدة تحكم Qianfan وتأكد من تفعيل وصول Qianfan API لديك.
2

إنشاء مفتاح API

أنشئ تطبيقًا جديدًا أو اختر تطبيقًا موجودًا، ثم أنشئ مفتاح API. تنسيق المفتاح هو bce-v3/ALTAK-....
3

تشغيل الإعداد الأولي

openclaw onboard --auth-choice qianfan-api-key
4

التحقق من توفر النموذج

openclaw models list --provider qianfan

​
الكتالوج المدمج

مرجع النموذجالإدخالالسياقالحد الأقصى للإخراجالاستدلالملاحظات
qianfan/deepseek-v3.2نص98,30432,768نعمالنموذج الافتراضي
qianfan/ernie-5.0-thinking-previewنص، صورة119,00064,000نعممتعدد الوسائط
مرجع النموذج الافتراضي هو qianfan/deepseek-v3.2. لا تحتاج إلى تجاوز models.providers.qianfan إلا عندما تحتاج إلى عنوان URL أساسي مخصص أو بيانات تعريف للنموذج.

​
مثال إعداد

{
  env: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." },
  agents: {
    defaults: {
      model: { primary: "qianfan/deepseek-v3.2" },
      models: {
        "qianfan/deepseek-v3.2": { alias: "QIANFAN" },
      },
    },
  },
  models: {
    providers: {
      qianfan: {
        baseUrl: "https://qianfan.baidubce.com/v2",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-v3.2",
            name: "DEEPSEEK V3.2",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 98304,
            maxTokens: 32768,
          },
          {
            id: "ernie-5.0-thinking-preview",
            name: "ERNIE-5.0-Thinking-Preview",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 119000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
}
يعمل Qianfan عبر مسار نقل متوافق مع OpenAI، وليس عبر تشكيل طلبات OpenAI الأصلية. يعني هذا أن ميزات OpenAI SDK القياسية تعمل، لكن قد لا تُمرَّر المعلمات الخاصة بالمزوّد.
يتضمن الكتالوج الثابت حاليًا deepseek-v3.2 وernie-5.0-thinking-preview. أضف أو تجاوز models.providers.qianfan فقط عندما تحتاج إلى عنوان URL أساسي مخصص أو بيانات تعريف للنموذج.
تستخدم مراجع النماذج البادئة qianfan/ (على سبيل المثال qianfan/deepseek-v3.2).
  • تأكد من أن مفتاح API لديك يبدأ بـ bce-v3/ALTAK- وأن وصول Qianfan API مفعّل في وحدة تحكم Baidu Cloud.
  • إذا لم تكن النماذج مدرجة، فتأكد من تفعيل خدمة Qianfan في حسابك.
  • عنوان URL الأساسي الافتراضي هو https://qianfan.baidubce.com/v2. لا تغيّره إلا إذا كنت تستخدم نقطة نهاية مخصصة أو وكيلًا.

​
ذات صلة

اختيار النموذج

اختيار المزوّدين، ومراجع النماذج، وسلوك تجاوز الفشل.

مرجع الإعداد

مرجع إعداد OpenClaw الكامل.

إعداد الوكيل

إعداد الإعدادات الافتراضية للوكلاء وتعيينات النماذج.

مستندات Qianfan API

وثائق Qianfan API الرسمية.