Providers
Qianfan
Qianfan to platforma MaaS firmy Baidu, udostępniająca ujednolicony interfejs API, który kieruje żądania do wielu modeli za jednym endpointem i kluczem API. Jest zgodna z OpenAI, więc większość zestawów SDK OpenAI działa po zmianie bazowego adresu URL.
| Właściwość | Wartość |
|---|---|
| Dostawca | qianfan |
| Uwierzytelnianie | QIANFAN_API_KEY |
| API | Zgodne z OpenAI |
| Bazowy adres URL | https://qianfan.baidubce.com/v2 |
Zainstaluj Plugin
Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartPierwsze kroki
Create a Baidu Cloud account
Zarejestruj się lub zaloguj w Qianfan Console i upewnij się, że masz włączony dostęp do API Qianfan.
Generate an API key
Utwórz nową aplikację lub wybierz istniejącą, a następnie wygeneruj klucz API. Format klucza to bce-v3/ALTAK-....
Run onboarding
openclaw onboard --auth-choice qianfan-api-keyVerify the model is available
openclaw models list --provider qianfanWbudowany katalog
| Odwołanie do modelu | Dane wejściowe | Kontekst | Maks. dane wyjściowe | Rozumowanie | Uwagi |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
tekst | 98,304 | 32,768 | Tak | Model domyślny |
qianfan/ernie-5.0-thinking-preview |
tekst, obraz | 119,000 | 64,000 | Tak | Multimodalny |
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, }, ], }, }, },}Transport and compatibility
Qianfan działa przez ścieżkę transportu zgodną z OpenAI, a nie przez natywne kształtowanie żądań OpenAI. Oznacza to, że standardowe funkcje SDK OpenAI działają, ale parametry specyficzne dla dostawcy mogą nie być przekazywane dalej.
Catalog and overrides
Statyczny katalog obejmuje obecnie deepseek-v3.2 i ernie-5.0-thinking-preview. Dodawaj lub nadpisuj models.providers.qianfan tylko wtedy, gdy potrzebujesz niestandardowego bazowego adresu URL lub metadanych modelu.
Troubleshooting
- Upewnij się, że 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 adres URL to
https://qianfan.baidubce.com/v2. Zmień go tylko wtedy, gdy używasz niestandardowego endpointu lub serwera proxy.
