Ana içeriğe atla

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, 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

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'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

Yerleşik katalog

Model refGirdiBağlamMaks. çı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 paketlenmiş model ref değeri qianfan/deepseek-v3.2 şeklindedir. Yalnızca özel bir temel URL’ye veya model meta verilerine ihtiyacınız olduğunda models.providers.qianfan değerini 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 biçimlendirmesiyle değil, 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 değerini yalnızca özel bir temel URL’ye veya model meta verilerine ihtiyacınız olduğunda ekleyin ya da geçersiz kılın.
Model ref değerleri 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. Yalnızca özel bir endpoint veya proxy kullanıyorsanız değiştirin.

İlgili

Model seçimi

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

Yapılandırma referansı

Eksiksiz OpenClaw yapılandırma referansı.

Agent kurulumu

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

Qianfan API belgeleri

Resmi Qianfan API belgeleri.