Ana içeriğe atla
Qianfan, Baidu’nun MaaS platformudur; istekleri tek bir endpoint ve API anahtarı arkasındaki birçok modele yönlendiren birleşik bir API sağlar. OpenAI uyumludur, bu nedenle çoğu OpenAI SDK’sı temel URL değiştirilerek çalışır.
ÖzellikDeğer
Sağlayıcıqianfan
Kimlik doğrulamaQIANFAN_API_KEY
APIOpenAI uyumlu
Temel URLhttps://qianfan.baidubce.com/v2

​
Plugin kur

Resmi Plugin’i kurun, ardından Gateway’i yeniden başlatın: 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
Başlarken

1

Baidu Cloud hesabı oluşturun

Qianfan Console üzerinden kaydolun veya oturum açın ve Qianfan API erişiminizin etkin olduğundan emin olun.
2

API anahtarı oluşturun

Yeni bir uygulama oluşturun veya mevcut bir uygulamayı seçin, ardından bir API anahtarı oluşturun. Anahtar biçimi bce-v3/ALTAK-... şeklindedir.
3

Onboarding çalıştırın

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

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider qianfan

​
Yerleşik katalog

Model refGirdiBağlamEn fazla çıktıAkıl yürütmeNotlar
qianfan/deepseek-v3.2metin98,30432,768EvetVarsayılan model
qianfan/ernie-5.0-thinking-previewmetin, görüntü119,00064,000EvetÇok modlu
Varsayılan model ref değeri qianfan/deepseek-v3.2 şeklindedir. models.providers.qianfan değerini yalnızca özel bir temel URL veya model meta verisi gerektiğinde geçersiz kılmanız gerekir.

​
Yapılandırma örneği

{
  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, yerel OpenAI istek şekillendirmesi yerine OpenAI uyumlu taşıma yolu üzerinden çalışır. Bu, standart OpenAI SDK özelliklerinin çalıştığı, ancak sağlayıcıya özgü parametrelerin iletilmeyebileceği anlamına gelir.
Statik katalog şu anda deepseek-v3.2 ve ernie-5.0-thinking-preview içerir. models.providers.qianfan değerini yalnızca özel bir temel URL veya model meta verisi gerektiğinde ekleyin ya da geçersiz kılın.
Model refs, qianfan/ önekini kullanır (örneğin qianfan/deepseek-v3.2).
  • API anahtarınızın bce-v3/ALTAK- ile başladığından ve Baidu Cloud konsolunda Qianfan API erişiminin etkin olduğundan emin olun.
  • Modeller listelenmiyorsa hesabınızda Qianfan hizmetinin etkinleştirildiğini doğrulayın.
  • Varsayılan temel URL https://qianfan.baidubce.com/v2 şeklindedir. Bunu yalnızca özel bir endpoint veya proxy kullanıyorsanız değiştirin.

​
İlgili

Model seçimi

Sağlayıcıları, model refs değerlerini ve failover davranışını seçme.

Yapılandırma başvurusu

Tam OpenClaw yapılandırma başvurusu.

Agent kurulumu

Agent varsayılanlarını ve model atamalarını yapılandırma.

Qianfan API belgeleri

Resmi Qianfan API belgeleri.