使用指南
方案与积分
开发者
FAQ
打开 waper
使用指南
方案与积分
开发者
FAQ
打开 waper
简体中文

REST API

和 MCP 同一套能力的 HTTP 版本，JSON over REST，Bearer 认证。

基础

Base URL: https://waper.ai/api/v1 OpenAPI: https://waper.ai/api/v1/openapi.json Auth: Authorization: Bearer <API Key>

约定

  • 列表返回 { items, nextCursor }，翻页用 ?cursor=；
  • 创建类调用支持 Idempotency-Key 头（24 小时内同一 Key 只执行一次）；
  • 错误是 RFC 9457 Problem JSON：{ type, title, status, detail, code }；
  • 音视频、深度研究这类长任务返回事件流（NDJSON）。

常用端点

方法 路径 说明
GET /me 当前账号信息
GET /watches 我的跟踪
POST /watches 新建跟踪（Idempotency-Key）
GET /watches/:id/briefs 简报列表
GET /briefs/:id 某一期简报
POST /library/links 收藏网页（body 是 URL，支持 Idempotency-Key）
POST /library/files 上传文件（X-File-Name 头）
GET /library 资料库检索
POST /agent/turns Agent 对话（NDJSON 流）
POST /media 解析音视频（返回报价）
GET /media/:id 逐字稿与总结

示例

curl -H "Authorization: Bearer wk_xxx" \
  https://waper.ai/api/v1/watches

curl -X POST https://waper.ai/api/v1/library/links \
  -H "Authorization: Bearer wk_xxx" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/article"}'

curl -X POST https://waper.ai/api/v1/agent/turns \
  -H "Authorization: Bearer wk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"text":"这周的 AI 简报有什么要点？","lang":"zh"}' \
  --no-buffer

限流与计费

  • 每个账号每分钟 60 次；
  • 按实际模型成本扣积分（/agent/turns、/media、/research 最贵；列表查询免费）；
  • 用量计数按天/按周/按月分别记，看积分。

OpenAPI

完整 schema 在 https://waper.ai/api/v1/openapi.json，可以直接导入 Postman / Insomnia / Swagger UI。

本页内容