Providers

Qianfan

Qianfan은 Baidu의 MaaS 플랫폼입니다. 단일 엔드포인트와 API 키를 통해 여러 모델로 요청을 라우팅하는 통합 OpenAI 호환 API입니다. OpenClaw는 이를 공식 외부 Plugin @openclaw/qianfan-provider로 제공합니다.

속성	값
제공자	`qianfan`
인증	`QIANFAN_API_KEY`
API	OpenAI 호환(`openai-completions`)
기본 URL	`https://qianfan.baidubce.com/v2`
기본 모델	`qianfan/deepseek-v3.2`

Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다.

bash

openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restart

시작하기

Baidu Cloud 계정 만들기

Qianfan Console에서 가입하거나 로그인한 후 Qianfan API 액세스가 활성화되어 있는지 확인합니다.

API 키 생성하기

새 애플리케이션을 만들거나 기존 애플리케이션을 선택한 다음 API 키를 생성합니다. Baidu Cloud 키는 bce-v3/ALTAK-... 형식을 사용합니다.

온보딩 실행하기

bash

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

비대화형 실행에서는 --qianfan-api-key <key> 또는 QIANFAN_API_KEY에서 키를 읽습니다. 온보딩은 제공자 구성을 작성하고, 기본 모델에 QIANFAN 별칭을 추가하며, 구성된 기본 모델이 없으면 qianfan/deepseek-v3.2를 기본 모델로 설정합니다.

모델 사용 가능 여부 확인하기

bash

openclaw models list --provider qianfan

기본 제공 카탈로그

모델 참조	입력	컨텍스트	최대 출력	추론	참고
`qianfan/deepseek-v3.2`	텍스트	98,304	32,768	예	기본 모델
`qianfan/ernie-5.0-thinking-preview`	텍스트, 이미지	119,000	64,000	예	멀티모달

카탈로그는 정적이며 실시간 모델 탐색은 지원하지 않습니다.

구성 예시

json5

{  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은 네이티브 OpenAI 요청 구성 방식이 아니라 OpenAI 호환 전송 경로를 통해 실행됩니다. 표준 OpenAI SDK 기능은 작동하지만 제공자별 매개변수는 전달되지 않을 수 있습니다.

문제 해결

API 키가 bce-v3/ALTAK-로 시작하고 Baidu Cloud 콘솔에서 Qianfan API 액세스가 활성화되어 있는지 확인합니다.
모델이 나열되지 않으면 계정에서 Qianfan 서비스가 활성화되어 있는지 확인합니다.
사용자 지정 엔드포인트나 프록시를 사용하는 경우에만 기본 URL을 변경합니다.

이 페이지에서

Qianfan

Plugin 설치

시작하기

Baidu Cloud 계정 만들기

API 키 생성하기

온보딩 실행하기

모델 사용 가능 여부 확인하기

기본 제공 카탈로그

구성 예시

관련 문서

Molty