云雀大模型不开放API，PHP无法直接调用；唯一可行路径是通过飞书开放平台Webhook中转并订阅事件，但存在延迟、截断、无流式响应等限制。
字节云雀大模型目前不对外开放 API 接口，PHP 无法直接调用。 官方未发布公开文档、申请入口、AK/SK 鉴权机制或 HTTP 接口规范，所有声称“云雀 API”的第三方 SDK、npm 包或 PHP 封装均为非官方、不可信或已失效内容。
为什么搜到的 PHP 调用示例都不可靠？
常见错误来源包括：
- 混淆「云雀」与字节跳动旗下其他模型（如
ByteDance/Cloud-LLM内部代号、LightRAG工具链、或已下线的Cloud-LLM-API测试通道） - 误将「飞书多维表格 AI 助手」或「Lark Bot + 云雀插件」的前端交互逻辑当作后端 API
- 复制粘贴过期的内部技术分享 PPT 中的伪代码（含
POST /v1/chat/completions路径但无真实 endpoint） - 用 cURL 硬套 OpenAI 格式（
https://api.cloudbu.com/v1/chat/completions等域名全部 404 或返回{"error":"invalid_request"}）
当前唯一可行的 PHP 集成路径：走飞书开放平台中转
若你已在飞书内启用「云雀」Bot，并获得企业管理员授权，可通过以下方式间接触发：
- PHP 后端调用
https://open.feishu.cn/open-apis/bot/v2/hook/{webhook_id}发送富文本消息，其中包含用户 prompt - 依赖飞书侧配置的「云雀 Bot 回复规则」自动响应（非实时、不可控、不返回结构化 JSON）
- 响应结果只能通过飞书消息事件订阅（
/event回调）捕获，需自建 HTTPS 服务并处理im:message:received事件 - 该流程无法保证 prompt 完整传递（飞书会截断超长文本）、无 streaming 支持、无 token 统计、无错误码映射
curl -X POST \
https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx-xxxxx-xxxxx \
-H 'Content-Type: application/json' \
-d '{
"msg_type": "text",
"content": {
"text": "请写一首关于服务器宕机的七言绝句"
}
}'
替代方案建议（实际可用）
如需在 PHP 项目中稳定接入大模型创意生成能力，推荐明确支持的方案：
立即学习“PHP免费学习笔记（深入）”；
- 切换为
Qwen2.5-7B或Qwen2.5-72B：阿里云百炼平台提供完整 PHP SDK，qwen-apiComposer 包可直接composer require alibabacloud/qwen - 使用
DeepSeek-V3：官方提供标准 OpenAI 兼容接口，PHP 可用guzzlehttp/guzzle直接调用https://api.deepseek.com/v1/chat/completions - 本地部署
llama.cpp+PHP exec()调用：适合离线创意生成，避免网络依赖和鉴权问题
云雀的模型能力虽强，但它的调用边界非常清晰——只存在于飞书客户端 UI 和内部 SaaS 集成中。任何试图绕过飞书生态、用 PHP 直连「云雀核心 API」的操作，都会卡在 DNS 解析失败或 403 Forbidden 上。
