Przejdź do głównej treści

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 to platforma MaaS firmy Baidu, zapewniająca ujednolicone API, które kieruje żądania do wielu modeli za jednym punktem końcowym i kluczem API. Jest zgodna z OpenAI, więc większość pakietów SDK OpenAI działa po zmianie bazowego URL-a.
WłaściwośćWartość
Dostawcaqianfan
UwierzytelnianieQIANFAN_API_KEY
APIzgodne z OpenAI
Bazowy URLhttps://qianfan.baidubce.com/v2

​
Pierwsze kroki

1

Utwórz konto Baidu Cloud

Zarejestruj się lub zaloguj w konsoli Qianfan i upewnij się, że masz włączony dostęp do API Qianfan.
2

Wygeneruj klucz API

Utwórz nową aplikację lub wybierz istniejącą, a następnie wygeneruj klucz API. Format klucza to bce-v3/ALTAK-....
3

Uruchom onboarding

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

Sprawdź, czy model jest dostępny

openclaw models list --provider qianfan

​
Wbudowany katalog

Odwołanie do modeluWejścieKontekstMaks. wyjścieRozumowanieUwagi
qianfan/deepseek-v3.2tekst98,30432,768TakModel domyślny
qianfan/ernie-5.0-thinking-previewtekst, obraz119,00064,000TakMultimodalny
Domyślne wbudowane odwołanie do modelu to qianfan/deepseek-v3.2. Musisz nadpisać models.providers.qianfan tylko wtedy, gdy potrzebujesz niestandardowego bazowego URL-a lub metadanych modelu.

​
Przykład konfiguracji

{
  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 działa przez ścieżkę transportu zgodną z OpenAI, a nie przez natywne kształtowanie żądań OpenAI. Oznacza to, że standardowe funkcje pakietów SDK OpenAI działają, ale parametry specyficzne dla dostawcy mogą nie być przekazywane dalej.
Wbudowany katalog obecnie obejmuje deepseek-v3.2 i ernie-5.0-thinking-preview. Dodaj lub nadpisz models.providers.qianfan tylko wtedy, gdy potrzebujesz niestandardowego bazowego URL-a lub metadanych modelu.
Odwołania do modeli używają prefiksu qianfan/ (na przykład qianfan/deepseek-v3.2).
  • Upewnij się, że Twój klucz API zaczyna się od bce-v3/ALTAK- i ma włączony dostęp do API Qianfan w konsoli Baidu Cloud.
  • Jeśli modele nie są wyświetlane, potwierdź, że usługa Qianfan jest aktywowana na Twoim koncie.
  • Domyślny bazowy URL to https://qianfan.baidubce.com/v2. Zmień go tylko wtedy, gdy używasz niestandardowego punktu końcowego lub proxy.

​
Powiązane

Wybór modelu

Wybieranie dostawców, odwołań do modeli i zachowania przełączania awaryjnego.

Dokumentacja konfiguracji

Pełna dokumentacja konfiguracji OpenClaw.

Konfiguracja agenta

Konfigurowanie domyślnych ustawień agentów i przypisań modeli.

Dokumentacja API Qianfan

Oficjalna dokumentacja API Qianfan.