虾太美 API

把 AI Agent 装进你的应用

通过 HTTP 接口让虾太美 AI Agent 执行对话和任务。所有接口走 HTTPS，使用灵途账号下颁发的 API Key 鉴权——和你在灵途其他产品里用的是同一把 Key。

Base URL

当前部署的 API 服务地址

本地开发：http://localhost:3005；生产域名以你的部署为准。

鉴权

所有 /api/v1/* 接口均要求在 Header 中传入 X-Api-Key：

X-Api-Key: <你的灵途 API Key>

没有 Key 的话，到 app.ailingtu.com/api-key-management 申请。这是和登录灵途账号同一套体系——你账号下的 Key 在所有灵途产品（包括虾太美）通用。

内容类型

所有请求体使用 application/json; charset=utf-8。

速率与限制

同一 Key 的并发与频率随灵途套餐而定。
单次消息内容建议不超过 8000 字。
AI 回复由 Agent Worker 异步处理。调用 /api/v1/chat 后请轮询 /api/v1/conversations/:id/messages 等待 role=assistant 消息出现。