Fogsight API对接需五步：一、确认本地服务运行于http://127.0.0.1:8000；二、正确配置credentials.json中API_KEY与BASE_URL；三、复现前端POST请求结构，含必要headers与cookies；四、可用Docker隔离部署；五、通过反向代理暴露服务并加固安全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试将雾象Fogsight接入自有系统或服务，但API调用失败或返回异常响应，则可能是由于凭证配置错误、网络策略限制或请求格式不合规。以下是完成API对接的具体步骤：
一、确认API服务模式与接口可用性
Fogsight当前未开放独立HTTP API端点供外部直接调用；其核心交互依赖本地运行的后端服务（由start_fogsight.py启动），所有生成请求均通过浏览器向http://127.0.0.1:8000发起POST请求，且该服务默认仅监听本地回环地址。因此，对接前提是确保调用方与Fogsight服务处于同一运行环境或可建立内网通信。
1、执行python start_fogsight.py后，检查终端是否输出“Uvicorn running on http://127.0.0.1:8000”字样。
2、在浏览器中访问http://127.0.0.1:8000，确认页面正常加载且“生成”按钮可点击。
3、使用curl命令验证接口连通性：curl -X POST http://127.0.0.1:8000/generate -H "Content-Type: application/json" -d '{"topic": "测试"}'，观察是否返回JSON格式的task_id。
二、配置credentials.json并验证模型连通性
credentials.json文件控制LLM底层调用能力，若BASE_URL或API_KEY填写错误，会导致生成任务卡在“脚本生成”阶段，表现为前端长时间显示“正在构思”。必须确保所填凭证能被对应模型服务商（如Google Gemini via OpenRouter）真实接受。
1、打开credentials.json文件，确认“API_KEY”字段值为有效密钥，不含多余空格或引号转义错误。
2、检查“BASE_URL”是否指向兼容OpenAI SDK的兼容接口，例如OpenRouter的https://openrouter.ai/api/v1或Gemini的代理地址。
3、在终端执行python -c "import requests; print(requests.get('YOUR_BASE_URL', headers={'Authorization': 'Bearer YOUR_API_KEY'}).status_code)"，替换其中URL与KEY，验证基础连通性。
三、模拟前端请求构造合法POST载荷
Fogsight前端通过标准表单提交触发后端任务，后端未暴露RESTful资源路径，需复现其请求结构才能实现程序化调用。关键字段包括topic、language、style等，且必须携带CSRF token（若启用安全策略）或匹配session上下文。
1、在浏览器开发者工具Network面板中，点击“生成”后捕获/generate请求，右键选择“Copy as cURL”，粘贴至文本编辑器查看完整headers与data。
