Ana içeriğe atla

​
Qianfan

Qianfan, Baidu’nun MaaS platformudur; istekleri tek bir uç nokta ve API anahtarı arkasında birçok modele yönlendiren birleşik bir API sağlar. OpenAI uyumludur, bu yüzden çoğu OpenAI SDK’sı taban URL’si değiştirilerek çalışır.
ÖzellikDeğer
Sağlayıcıqianfan
Kimlik doğrulamaQIANFAN_API_KEY
APIOpenAI uyumlu
Taban URLhttps://qianfan.baidubce.com/v2

​
Başlangıç

1

Bir Baidu Cloud hesabı oluşturun

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

Bir 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'i ç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

​
Kullanılabilir modeller

Model başvurusuGirdiBağlamMaks çıktıReasoningNotlar
qianfan/deepseek-v3.2metin98,30432,768EvetVarsayılan model
qianfan/ernie-5.0-thinking-previewmetin, görüntü119,00064,000EvetÇok modlu
Varsayılan paketlenmiş model başvurusu qianfan/deepseek-v3.2 şeklindedir. models.providers.qianfan ayarını yalnızca özel bir taban URL veya model metadata’sı 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.
Paketlenmiş katalog şu anda deepseek-v3.2 ve ernie-5.0-thinking-preview içerir. models.providers.qianfan öğesini yalnızca özel bir taban URL veya model metadata’sı gerektiğinde ekleyin ya da geçersiz kılın.
Model başvuruları qianfan/ ön ekini 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 taban URL https://qianfan.baidubce.com/v2 şeklindedir. Bunu yalnızca özel bir uç nokta veya proxy kullanıyorsanız değiştirin.

​
İlgili

Model seçimi

Sağlayıcıları, model başvurularını ve yük devretme davranışını seçme.

Yapılandırma başvurusu

Tam OpenClaw yapılandırma başvurusu.

Aracı kurulumu

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

Qianfan API belgeleri

Resmi Qianfan API belgeleri.