隔空看看

让 AI 看见
用户眼前的屏幕。

发一个带你品牌的邀请链接。用户允许共享后,你的 AI 就能按需取得当前画面,一步步指导。

聊天和语音由你的应用提供。我们处理屏幕共享连接和画面接收。由用户选择共享范围,不用安装软件,不录制、不采集声音,也不能远程操作。

先用模拟会话试一遍。

发邮件到 hello@seewithyou.com 申请试用凭证和品牌配置。凭证只放在你的服务器,不要放进网页。文档所在网站的域名就是 API 的基础地址。

export SEE_WITH_YOU_URL="https://agents.seewithyou.com"
export SEE_WITH_YOU_KEY="你的试用凭证"

curl "$SEE_WITH_YOU_URL/v1/sessions" \
  -H "Authorization: Bearer $SEE_WITH_YOU_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-test" \
  -d '{"mode":"sandbox"}'

# 用返回的 id 取样例画面:
curl "$SEE_WITH_YOU_URL/v1/sessions/会话ID/screen" \
  -H "Authorization: Bearer $SEE_WITH_YOU_KEY" \
  -o screen.jpg

模拟会话只返回明确标注的样例图,不创建真实房间,也不读取任何人的屏幕。完整参数见 OpenAPI 文件。

接入 MCP。

给支持远程 MCP 的客户端配置本站的 /mcp 地址,使用 Streamable HTTP,并携带 Authorization: Bearer 你的凭证。不同宿主的配置字段会不同;首版使用已有凭证,不提供交互式 OAuth 登录。

{
  "url": "https://agents.seewithyou.com/mcp",
  "headers": {"Authorization": "Bearer 你的凭证"}
}
工具用途
create_session创建真实共享邀请,或创建模拟会话。
get_status确认用户是否开始共享,每 2 秒查一次。
get_screen取得当前图片和采集时间,每秒最多一次。
end_session永久结束会话并释放接收资源。

开始真实共享。

POST /v1/sessions
{"mode":"live","language":"zh","assistant_name":"你的 AI 助手"}

通过已有聊天系统把 share_url 发给用户。邀请页显示凭证所属客户的品牌。链接 # 后面的令牌只能用于分享自己的屏幕,不能读取画面。

查询 GET /v1/sessions/{id},等到状态为 sharing,再按需调用 GET /v1/sessions/{id}/screen。HTTP 返回 JPEG,X-Screen-* 响应头包含采集时间、帧号、尺寸;MCP 直接返回图片内容块。

等待、暂停、断连或画面过旧时返回 409;结束或过期返回 410;超过限额返回 429 和 Retry-After。不要把旧画面当成当前状态。完成后调用 POST /v1/sessions/{id}/end。

首版的边界。

AI 会话隐私说明 · 预览品牌邀请页