Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 dapat bekerja dengan mengganti URL dasar.
PropertiNilai
Penyediaqianfan
AutentikasiQIANFAN_API_KEY
APIKompatibel dengan OpenAI
URL Dasarhttps://qianfan.baidubce.com/v2

​
Memulai

1

Buat akun Baidu Cloud

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

Buat kunci API

Buat aplikasi baru atau pilih 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 model tersedia

openclaw models list --provider qianfan

​
Katalog bawaan

Ref modelInputKonteksOutput maksPenalaranCatatan
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 menimpa models.providers.qianfan saat membutuhkan URL dasar kustom 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. Artinya fitur SDK OpenAI standar berfungsi, tetapi parameter khusus penyedia mungkin tidak diteruskan.
Katalog bawaan saat ini mencakup deepseek-v3.2 dan ernie-5.0-thinking-preview. Tambahkan atau timpa models.providers.qianfan hanya saat Anda membutuhkan URL dasar kustom 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, pastikan akun Anda telah mengaktifkan layanan Qianfan.
  • URL dasar default adalah https://qianfan.baidubce.com/v2. Ubah hanya jika Anda menggunakan endpoint kustom atau proksi.

​
Terkait

Pemilihan model

Memilih penyedia, ref model, dan perilaku failover.

Referensi konfigurasi

Referensi konfigurasi lengkap OpenClaw.

Penyiapan agen

Mengonfigurasi default agen dan penetapan model.

Dokumentasi API Qianfan

Dokumentasi API Qianfan resmi.