文心快码是百度千帆平台下独立备案的代码生成模型系列，不支持文心一言API Key调用，需在千帆控制台开通服务并获取专属API Key和Secret Key；推荐使用OpenAI兼容模式接入，通过指定base_url调用；也支持离线容器部署及VS Code插件直连。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在本地项目中直接调用文心快码（Wenxin Code）的代码生成能力，但官方SDK文档零散、接口变更频繁，手动拼接签名和请求体容易出错，又不想每次换模型都重写鉴权逻辑。
确认文心快码是否已开放独立API通道
文心快码不是文心一言的子模块，而是百度千帆平台下独立备案的代码生成模型系列，当前（2026年7月）仅通过千帆大模型平台提供服务，【不支持直接使用文心一言API Key调用】。必须先在百度智能云千帆控制台开通“文心快码”服务并创建专属应用。
登录千帆控制台 → 进入「模型服务」→ 搜索“wenxin-code” → 点击「开通服务」→ 在「应用管理」中新建应用，勾选“文心快码-4.5”或“wenxin-code-pro”等具体模型标识。
应用创建成功后，你会获得一对凭证：API Key 和 Secret Key。注意：这组密钥与文心一言的密钥完全隔离，不可混用。
Python项目中接入文心快码（推荐OpenAI兼容模式）
千帆平台自2026年3月起全面支持OpenAI兼容接口，文心快码已纳入该协议覆盖范围。你无需安装百度专用SDK，只需用标准openai库即可调用。
第一步：安装新版OpenAI SDK（必须≥1.42.0）
pip install --upgrade openai
第二步：初始化客户端，base_url必须指向千帆OpenAI兼容网关
from openai import OpenAI
client = OpenAI(
api_key="your_qianfan_api_key",
secret_key="your_qianfan_secret_key", # 注意：openai官方SDK不原生支持secret_key，此处需配合千帆封装层
base_url="https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/code/completions"
)
⚠️关键提醒：上面的base_url是千帆为文心快码单独分配的路径，不是通用聚合端点。若填错为taotoken或通用wenxinworkshop/chat/completions地址，会返回404或“模型未授权”错误。
第三步：构造符合文心快码语义的messages结构
文心快码对system角色有强约束——必须显式声明编程语言和任务类型。例如：
messages = [
{"role": "system", "content": "你是一个Python专家，专注生成可运行、带类型注解、含单元测试的函数代码。"},
{"role": "user", "content": "写一个接收列表和阈值，返回所有大于阈值的偶数的函数"}
]
本地部署文心快码轻量版（仅限推理）
百度官方未开源文心快码模型权重，但千帆平台提供「离线推理容器」下载服务，适用于内网环境或安全审计严格的企业场景。
方法一：使用千帆ModelScope镜像一键拉取
docker pull registry.baidubce.com/qianfan/wenxin-code-pro:202607-offline
方法二：手动部署（需GPU服务器）
① 登录千帆控制台 → 进入「模型仓库」→ 找到wenxin-code-pro → 点击「导出离线包」→ 下载.tar.gz文件
② 解压后执行./install.sh，脚本会自动检查CUDA版本（要求12.1+）、安装依赖并启动FastAPI服务
③ 默认监听0.0.0.0:8000，请求方式与在线API一致，仅需将base_url改为http://localhost:8000/v1
注意：离线包不含训练能力，且模型ID固定为wenxin-code-pro-offline，无法切换其他版本。
方法三：VS Code插件直连（开发者友好）
安装「Qwen & Wenxin Code Assistant」插件（v2.8.3+），在设置中填入千帆应用的API Key和Secret Key，插件会自动识别当前文件语言并路由至最优文心快码模型，无需写任何代码。
