快速上手

从零到「看到真实 SSE 流」只要四步:注册 → 签发 key → curl 调用 → 看懂事件流。全程约 5 分钟。

第 1 步:打开控制台,登录即注册

浏览器打开 /console,两种登录方式任选,首次登录自动开通租户(你的 key、用量、人格、会话全部隔离在自己的租户里):

方式流程说明
GitHub(推荐)点「用 GitHub 登录」→ 授权 → 自动跳回控制台要求 GitHub 账号有已验证(verified)邮箱
邮箱验证码填邮箱 → 收 6 位验证码 → 填码登录验证码 5 分钟有效,错 5 次锁定需重发

登录态是一个 7 天有效的 httpOnly cookie,只在浏览器里用;机器调 API 不用它,用下一步的 API key。

第 2 步:签发 API key

控制台里点「签发新 Key」:

第 3 步:curl 调 /v1/agent

bash
BASE="https://api.cloud.novameow.ai"   # 或你自部署的域名
KEY="sk-meow-……"                                     # 上一步签发的 key

curl -N "$BASE/v1/agent" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"今天上海天气怎么样喵?","session_id":"s1"}'

-N 关掉 curl 缓冲才能看到流式效果。响应是 text/event-stream,形如:

code
event: tool_call
data: {"type":"tool_call","name":"web_search"}

event: tool_result
data: {"type":"tool_result","name":"web_search","ok":true}

event: llm_delta
data: {"type":"llm_delta","text":"今天上海多云,"}

event: stats
data: {"type":"stats","iterations":2}

event: llm_end
data: {"type":"llm_end","reply":"今天上海多云,出门挺舒服的喵。"}

事件名与字段形状是稳定契约;具体回复文本因模型而异。tool_call / tool_result 只在模型决定调工具时出现。

第 4 步:马上能玩的花样

bash
# 多轮记忆:带同一个 session_id 再发一条,上文还在
curl -N "$BASE/v1/agent" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"那适合穿什么喵?","session_id":"s1"}'

# 视觉:传图片 URL 或 data: base64
curl -N "$BASE/v1/agent" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"这是什么喵?","session_id":"s2","images":["https://example.com/cat.jpg"]}'

# 临时换人格:仅本次请求有效
curl -N "$BASE/v1/agent" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"帮我审下这段文案","session_id":"s3","persona":"你是一位严谨的中文编辑"}'

下一步