Pular para o conteúdo principal

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 é a plataforma MaaS da Baidu, fornecendo uma API unificada que encaminha solicitações para muitos modelos por trás de um único endpoint e chave de API. Ela é compatível com OpenAI, então a maioria dos SDKs da OpenAI funciona ao trocar a URL base.
PropriedadeValor
Provedorqianfan
AutenticaçãoQIANFAN_API_KEY
APICompatível com OpenAI
URL basehttps://qianfan.baidubce.com/v2

​
Primeiros passos

1

Criar uma conta da Baidu Cloud

Cadastre-se ou faça login no Console do Qianfan e verifique se você tem o acesso à API do Qianfan habilitado.
2

Gerar uma chave de API

Crie uma nova aplicação ou selecione uma existente e, em seguida, gere uma chave de API. O formato da chave é bce-v3/ALTAK-....
3

Executar a integração

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

Verificar se o modelo está disponível

openclaw models list --provider qianfan

​
Catálogo integrado

Ref do modeloEntradaContextoSaída máximaRaciocínioObservações
qianfan/deepseek-v3.2texto98,30432,768SimModelo padrão
qianfan/ernie-5.0-thinking-previewtexto, imagem119,00064,000SimMultimodal
A ref de modelo padrão incluída é qianfan/deepseek-v3.2. Você só precisa substituir models.providers.qianfan quando precisar de uma URL base personalizada ou metadados de modelo.

​
Exemplo de configuração

{
  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,
          },
        ],
      },
    },
  },
}
O Qianfan é executado pelo caminho de transporte compatível com OpenAI, não pela formatação nativa de solicitações da OpenAI. Isso significa que os recursos padrão dos SDKs da OpenAI funcionam, mas parâmetros específicos do provedor podem não ser encaminhados.
No momento, o catálogo incluído inclui deepseek-v3.2 e ernie-5.0-thinking-preview. Adicione ou substitua models.providers.qianfan somente quando precisar de uma URL base personalizada ou metadados de modelo.
Refs de modelo usam o prefixo qianfan/ (por exemplo, qianfan/deepseek-v3.2).
  • Verifique se sua chave de API começa com bce-v3/ALTAK- e se tem acesso à API do Qianfan habilitado no console da Baidu Cloud.
  • Se os modelos não estiverem listados, confirme que sua conta tem o serviço Qianfan ativado.
  • A URL base padrão é https://qianfan.baidubce.com/v2. Altere-a somente se você usar um endpoint ou proxy personalizado.

​
Relacionado

Seleção de modelo

Escolha de provedores, refs de modelo e comportamento de failover.

Referência de configuração

Referência completa de configuração do OpenClaw.

Configuração do agente

Configuração de padrões de agente e atribuições de modelo.

Documentação da API do Qianfan

Documentação oficial da API do Qianfan.