GET
/health
检查服务状态，返回服务是否可用、并发配置和正在执行的任务 ID。
请求示例
curl -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/health
响应示例
{"ok":true,"browser_workers":4,"active":[]}
GET
/config/proxy-api
读取当前代理提取 API 配置。
请求示例
curl -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/config/proxy-api
响应示例
{"proxy_api_url":"https://example.com/get","proxy_api_scheme":"http","proxy_api_timeout_seconds":20}
GET
/config/workers
读取当前并发配置。
请求示例
curl -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/config/workers
响应示例
{"browser_workers":100,"max_effective_workers":32,"effective_browser_workers":32,"capacity_limit":32}
POST
/config/workers
分别修改配置并发和真实有效并发上限，范围均为 1 - 999；内存压力过高时系统仍会自动降载。
请求示例
curl -X POST -H "X-API-Token: $API_TOKEN" -H "Content-Type: application/json" -d '{"browser_workers":100,"max_effective_workers":32}' http://SERVER_IP:8088/config/workers
响应示例
{"ok":true,"browser_workers":100,"max_effective_workers":32,"effective_browser_workers":32}
POST
/config/proxy-api
修改代理提取 API。JSON 示例：{"proxy_api_url":"https://example.com/get","proxy_api_scheme":"http"}
请求示例
curl -X POST -H "X-API-Token: $API_TOKEN" -H "Content-Type: application/json" -d '{"proxy_api_url":"https://example.com/get","proxy_api_scheme":"http"}' http://SERVER_IP:8088/config/proxy-api
响应示例
{"ok":true,"proxy_api_url":"https://example.com/get","proxy_api_scheme":"http","proxy_api_timeout_seconds":20}
POST
/tasks
提交任务，使用 multipart/form-data，字段：prompt、ratio、images。图片最多按后端配置接收。
请求示例
curl -X POST -H "X-API-Token: $API_TOKEN" -F "prompt=一个人在奔跑健身" -F "ratio=9:16" http://SERVER_IP:8088/tasks
响应示例
{"id":"0123456789abcdef0123456789abcdef"}
GET
/tasks
获取当前任务列表。
请求示例
curl -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/tasks
响应示例
{"tasks":[{"id":"0123456789abcdef0123456789abcdef","prompt_preview":"一个人在奔跑健身","status":"success","image_count":0,"error":""}]}
DELETE
/tasks
批量清空未在生成中的任务，生成中的任务会自动保留。
请求示例
curl -X DELETE -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/tasks
响应示例
{"ok":true,"deleted":10,"skipped":[]}
GET
/tasks/{task_id}
查询单个任务状态和结果。
请求示例
curl -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/tasks/0123456789abcdef0123456789abcdef
响应示例
{"code":"2","text":"","url":"https://example.com/video.mp4"}
DELETE
/tasks/{task_id}
删除未在生成中的任务；生成中任务会返回不可取消。
请求示例
curl -X DELETE -H "X-API-Token: $API_TOKEN" http://SERVER_IP:8088/tasks/0123456789abcdef0123456789abcdef
响应示例
{"ok":true}
