Qianfan Provider 설정하기

새로운 모델이 나올 때마다 매번 다른 API 구조를 익히고 연동 코드를 새로 짜는 건 꽤 피곤한 일이에요. 특히 여러 모델을 조합해서 사용해야 할 때는 관리해야 할 API 키와 엔드포인트가 늘어나면서 개발 흐름이 끊기기도 하죠. 이런 번거로움을 줄이고 하나의 접점에서 여러 모델을 다룰 수 있는 방법이 필요합니다.

Qianfan은 Baidu의 MaaS 플랫폼으로, 단일 엔드포인트와 API key를 통해 여러 모델로 요청을 라우팅할 수 있는 unified API를 제공해요. OpenAI와 호환되기 때문에 base URL만 바꾸면 대부분의 OpenAI SDK를 그대로 사용할 수 있습니다.

필요한 것

시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

• Qianfan API 권한이 있는 Baidu Cloud 계정
• Qianfan 콘솔에서 발급받은 API key
• 시스템에 설치된 OpenClaw

빠른 시작

5분 안에 설정을 마칠 수 있는 가장 빠른 방법입니다.

1. Qianfan 콘솔에 접속하세요.
2. 새 애플리케이션을 만들거나 기존에 있는 항목을 선택하세요.
3. API key를 생성하세요. (형식: bce-v3/ALTAK-...)
4. 생성된 API key를 OpenClaw에서 사용할 수 있도록 복사해 둡니다.
5. 터미널을 열고 아래 명령어를 실행하세요.

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

문제 해결

• API key 오류: 입력한 API key가 bce-v3/ALTAK-... 형식이 맞는지 다시 한번 확인해 보세요.

설정 과정에서 도움이 더 필요하다면 AI Setup Assistant에게 물어보세요.

다음 단계

• OpenClaw Configuration
• Model Providers
• Agent Setup
• Qianfan API Documentation