Menu
Quick reference for all API endpoints. Use when you need to know available endpoints, their methods, and purposes.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Add a new FastAPI API endpoint. Use when creating new REST API routes for the application.
Add a new LLM provider to fusion-api. Use when integrating a new AI model service.
Fusion API 项目架构、技术栈、核心组件总览。Use when you need to understand how the backend works, its architecture, or tech stack.
Debug streaming issues (stop not working, content loss, reconnect problems). Use when SSE streaming has bugs.
查看 dev 服务器 fusion-api 日志。Use when debugging backend issues, checking errors, or tracing request flow.
用 curl 测试 dev 服务器 API 端点。Use to verify API behavior, test streaming, or debug issues end-to-end.
| name | api-reference |
| description | Quick reference for all API endpoints. Use when you need to know available endpoints, their methods, and purposes. |
/api/chat)| Method | Path | 说明 |
|---|---|---|
| POST | /send | 发送消息（流式/非流式） |
| GET | /conversations | 分页对话列表（page, page_size） |
| GET | /conversations/{id} | 对话详情（含完整消息） |
| DELETE | /conversations/{id} | 删除对话 |
| PUT | /conversations/{id}/messages/{msg_id} | 编辑消息 |
| POST | /generate-title | 自动生成对话标题 |
| POST | /suggest-questions | 生成推荐后续问题 |
| GET | /stream-status/{conv_id} | 查询流状态（streaming/cancelled/done） |
| GET | /stream/{conv_id} | 断线重连 SSE（last_entry_id 参数） |
| POST | /stop/{conv_id} | 停止生成（message_id 参数防误杀） |
POST /send:
{
"model_id": "qwen3-235b-a22b",
"message": "你好",
"conversation_id": null,
"stream": true,
"options": {"use_reasoning": true},
"file_ids": ["uuid"]
}
SSE 帧格式:
id: {redis_entry_id}
data: {"id": "{msg_id}", "conversation_id": "{conv_id}", "choices": [{"delta": {"content": [{"type": "text", "id": "blk_xxx", "text": "..."}]}, "finish_reason": null}]}
SSE content block 类型:
| type | 字段 | 说明 |
|---|---|---|
thinking | thinking | 推理过程增量文本 |
text | text | 回答正文增量文本 |
search | search_event, query, sources? | 搜索事件（start 或 complete） |
搜索相关 SSE 事件示例:
// search_start
{"type": "search", "id": "blk_xxx", "search_event": "start", "query": "搜索关键词"}
// search_complete
{"type": "search", "id": "blk_xxx", "search_event": "complete", "query": "...", "sources": [{"title": "...", "url": "...", "description": "..."}]}
/api/files)| Method | Path | 说明 |
|---|---|---|
| POST | /upload | 上传文件（multipart/form-data） |
| GET | / | 用户文件列表 |
| GET | /conversation/{id} | 对话关联文件 |
| GET | /{file_id}/status | 文件处理状态 |
| DELETE | /{file_id} | 删除文件 |
/api/models)| Method | Path | 说明 |
|---|---|---|
| GET | / | 模型列表 |
| GET | /{model_id} | 模型详情 |
| POST | / | 创建模型 |
| PUT | /{model_id} | 更新模型 |
| DELETE | /{model_id} | 删除模型 |
| GET | /{model_id}/credentials | 凭证列表 |
| POST | /{model_id}/credentials | 创建凭证 |
| PUT | /credentials/{cred_id} | 更新凭证 |
| DELETE | /credentials/{cred_id} | 删除凭证 |
| POST | /credentials/test | 测试凭证 |
/api/auth)| Method | Path | 说明 |
|---|---|---|
| GET | /me | 当前用户信息 |
| Method | Path | 说明 |
|---|---|---|
| GET | /health | 健康检查（数据库连接状态） |
所有端点（除 /health）需要 JWT：
Authorization: Bearer <access_token>
Token 从 auth-service（端口 8100）获取。