用途:Manus API 提供 AI 智能体(agent)任务执行能力,可用于自动化多步骤研究、分析等任务。基础地址为 https://api.manus.ai/v2,鉴权使用请求头 x-manus-api-key: $MANUS_TOKEN。
主要能力:
- 创建任务:POST /task.create,请求体包含 message.content 文本,可附加 title、locale、agent_profile、share_visibility、interactive_mode 等选项。agent_profile 可选 manus-1.6(默认)、manus-1.6-lite(更快更低成本)、manus-1.6-max(更高质量)。
- 任务可通过 message.connectors 传入连接器 UUID,接入 Gmail、Notion、Google Calendar 等外部工具;可通过 enable_skills、force_skills 指定技能。
- 查询任务:GET /task.detail?task_id=<task-id>,返回 status、credit_usage、task_url,status 取值 pending、running、completed、failed、cancelled。
- 项目:POST /project.create、GET /project.list,创建任务时可传 project_id 复用指令。
- 文件:先 POST /file.upload 获取 file.id 与 upload_url,再 PUT 文件内容;文件状态需为 uploaded 才能附加,上传后 48 小时过期,upload_url 3 分钟内有效。
- Webhook:POST /webhook.create 与 POST /webhook.delete,用于异步接收任务状态更新。
使用方式:任务为异步,需轮询 task.detail 直至 completed 或 failed,生产环境建议使用 Webhook。限速为每 API 密钥每秒 10 次请求。任务按复杂度消耗积分,简单任务可用 manus-1.6-lite 降低成本。
限制与排障:请求失败时可运行 zero doctor check-connector --env-name MANUS_TOKEN 或 zero doctor check-connector --url https://api.manus.ai/v2/task.detail?task_id= --method GET。费用、价格与具体平台情况资料暂未提供。