Langsung ke konten utama
Qianfan adalah platform MaaS Baidu, yang menyediakan API terpadu yang merutekan permintaan ke banyak model di balik satu endpoint dan kunci API. Platform ini kompatibel dengan OpenAI, sehingga sebagian besar SDK OpenAI berfungsi dengan mengganti URL dasar.
PropertiNilai
Penyediaqianfan
AuthQIANFAN_API_KEY
APIKompatibel dengan OpenAI
URL dasarhttps://qianfan.baidubce.com/v2

​
Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway: 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
Memulai

1

Buat akun Baidu Cloud

Daftar atau masuk di Konsol Qianfan dan pastikan akses API Qianfan telah diaktifkan.
2

Buat kunci API

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

Jalankan onboarding

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

Verifikasi bahwa model tersedia

openclaw models list --provider qianfan

​
Katalog bawaan

Ref modelMasukanKonteksOutput maksimumPenalaranCatatan
qianfan/deepseek-v3.2teks98,30432,768YaModel default
qianfan/ernie-5.0-thinking-previewteks, gambar119,00064,000YaMultimodal
Ref model default adalah qianfan/deepseek-v3.2. Anda hanya perlu mengganti models.providers.qianfan saat memerlukan URL dasar khusus atau metadata model.

​
Contoh konfigurasi

{
  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 berfungsi, tetapi parameter khusus penyedia mungkin tidak diteruskan.
Katalog statis saat ini mencakup deepseek-v3.2 dan ernie-5.0-thinking-preview. Tambahkan atau ganti models.providers.qianfan hanya saat Anda memerlukan URL dasar khusus atau metadata model.
Ref model menggunakan prefiks qianfan/ (misalnya qianfan/deepseek-v3.2).
  • Pastikan kunci API Anda dimulai dengan bce-v3/ALTAK- dan akses API Qianfan telah diaktifkan di konsol Baidu Cloud.
  • Jika model tidak tercantum, konfirmasikan bahwa layanan Qianfan telah diaktifkan untuk akun Anda.
  • URL dasar default adalah https://qianfan.baidubce.com/v2. Ubah hanya jika Anda menggunakan endpoint atau proxy khusus.

​
Terkait

Pemilihan model

Memilih penyedia, 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.