Langsung ke konten utama

​
Qianfan

Qianfan adalah platform MaaS milik Baidu yang menyediakan API terpadu yang merutekan permintaan ke banyak model di balik satu endpoint dan kunci API. API ini kompatibel dengan OpenAI, sehingga sebagian besar SDK OpenAI dapat digunakan hanya dengan mengganti base URL.
PropertyValue
Providerqianfan
AutentikasiQIANFAN_API_KEY
APIKompatibel OpenAI
Base URLhttps://qianfan.baidubce.com/v2

​
Memulai

1

Buat akun Baidu Cloud

Daftar atau masuk di Qianfan Console dan pastikan akses API Qianfan sudah diaktifkan.
2

Buat kunci API

Buat aplikasi baru atau pilih yang sudah ada, lalu buat kunci API. Format key adalah bce-v3/ALTAK-....
3

Jalankan onboarding

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

Verifikasi bahwa model tersedia

openclaw models list --provider qianfan

​
Model yang tersedia

Ref modelInputKonteksOutput maksReasoningCatatan
qianfan/deepseek-v3.2teks98,30432,768YaModel default
qianfan/ernie-5.0-thinking-previewteks, gambar119,00064,000YaMultimodal
Ref model bawaan default adalah qianfan/deepseek-v3.2. Anda hanya perlu mengoverride models.providers.qianfan jika memerlukan base URL atau metadata model kustom.

​
Contoh config

{
  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 berjalan melalui jalur transport yang kompatibel dengan OpenAI, bukan pembentukan permintaan OpenAI native. Ini berarti fitur SDK OpenAI standar tetap berfungsi, tetapi parameter khusus provider mungkin tidak diteruskan.
Katalog bawaan saat ini mencakup deepseek-v3.2 dan ernie-5.0-thinking-preview. Tambahkan atau override models.providers.qianfan hanya jika Anda memerlukan base URL atau metadata model kustom.
Ref model menggunakan prefiks qianfan/ (misalnya qianfan/deepseek-v3.2).
  • Pastikan kunci API Anda diawali dengan bce-v3/ALTAK- dan akses API Qianfan sudah diaktifkan di konsol Baidu Cloud.
  • Jika model tidak tercantum, pastikan akun Anda telah mengaktifkan layanan Qianfan.
  • Base URL default adalah https://qianfan.baidubce.com/v2. Ubah hanya jika Anda menggunakan endpoint atau proxy kustom.

​
Terkait

Pemilihan model

Memilih provider, ref model, dan perilaku failover.

Referensi konfigurasi

Referensi konfigurasi OpenClaw lengkap.

Penyiapan agent

Mengonfigurasi default agent dan penetapan model.

Dokumentasi API Qianfan

Dokumentasi API Qianfan resmi.