用途:通过 Gooseworks 代理接入 Perplexity,实现实时网络数据驱动的 AI 搜索与对话补全,适用于研究、时事追踪、技术问答、事实核查与内容创作。
主要能力:Chat Completions 生成对话回复;Search 返回排名搜索结果并支持过滤;异步 Chat Completions 提交与查询任务;列出异步请求。模型可选 sonar、sonar-pro、sonar-deep-research、sonar-reasoning-pro。支持 search_mode(academic、sec、web)、reasoning_effort、temperature、top_p、域名过滤、时间过滤、语言偏好、返回图片与相关问题、结构化 JSON 输出、禁用搜索等参数。
用法:先读取 ~/.gooseworks/credentials.json 获取凭据并导出环境变量;若文件不存在,运行 npx gooseworks login。所有端点使用 Bearer 认证。例如同步对话: curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run -H "Authorization: Bearer $GOOSEWORKS_API_KEY" -H "Content-Type: application/json" -d '{"api":"perplexity","path":"/chat/completions"...}' 搜索:path 设为 /search;异步:path 设为 /async/chat/completions。
限制:reasoning_effort 仅适用于 sonar-deep-research;domain filter 最多 20 个;语言过滤最多 10 个;异步任务需另行查询状态;具体价格与配额暂未提供。