الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

بدء الاستخدام

1

Create a Baidu Cloud account

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

Generate an API key

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

Run onboarding

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

Verify the model is available

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 الأصلي. يعني ذلك أن ميزات SDK القياسية الخاصة بـ OpenAI تعمل، لكن قد لا يتم تمرير المعلمات الخاصة بالمزوّد.
يتضمن الكتالوج المضمّن حاليًا 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. لا تغيّره إلا إذا كنت تستخدم نقطة نهاية مخصصة أو وكيلًا.

ذات صلة

Model selection

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

Configuration reference

مرجع تكوين OpenClaw الكامل.

Agent setup

تكوين افتراضيات الوكيل وتعيينات النماذج.

Qianfan API docs

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