可重复使用的租用 · REST + MCP

一个 一直属于你的号码

租一个私有号码，一天或更久，整个租期内持续接收消息。先看看有哪些时长区间可用、分别多少钱，买下一个，任务拖长了就续期，用完了就取消。

连接你的 AI 客户端 跳到 REST 快速上手
有效时长
一天起
你会得到
多条短信
最适合
会话、测试与持续使用
800+ 覆盖的服务
200+ 有货的国家
无需注册 即可查看价格
按号码计费 从不订阅

开始接入

一分钟内拿到 API 密钥

用邮箱注册即可，无需信用卡，也不用等销售联系。登录链接会把你带回本页，并直接给出一把同时适用于 REST API 和 MCP 服务器的密钥。

创建免费，按号码付费，不是订阅制。

工作方式

四个步骤，从头到尾

下面每一步都对应真实的接口和真实的工具。请保留购买返回的 id —— 之后的一切都依赖它。

  1. 1

    查询实时库存

    列出服务、国家以及可租用的时长区间，并给出各自当前的精确美元价格。

    GET /v1/sms/rental/servicesGET /v1/sms/rental/countriesGET /v1/sms/rental/intervals sms_rental_list_servicessms_rental_list_countriessms_rental_list_intervals
  2. 2

    按时长区间租用

    选择预付余额或无账户的 x402，然后保存返回的租用 id。

    POST /v1/sms/rental/numbers sms_rental_buy_number
  3. 3

    收取消息

    在整个租期内轮询，并使用游标获取多条消息而不重复。

    GET /v1/sms/rental/numbers/{id}/codes sms_rental_get_codes
  4. 4

    取消或续期

    在可退款时取消，或列出可用的续期时长与价格，为进行中的租用续期。

    POST /v1/sms/rental/numbers/{id}/cancelGET /v1/sms/rental/numbers/{id}/extend-optionsPOST /v1/sms/rental/numbers/{id}/extend sms_rental_cancelsms_rental_list_extend_optionssms_rental_extend

只需配置一次

把 Voxisim 装进你的 AI 客户端

连接托管的接入点，你的智能体就能比价、买号并把验证码交给你，你一行请求都不用写。没有任何东西需要安装：没有软件包、没有本地服务、没有容器 —— 只有一个 URL 和一次浏览器登录。

托管接入点 https://api.voxisim.com/mcp
Streamable HTTP · OAuth 或 bearer 密钥
  1. 01

    添加接入点

    在下面选择你的客户端，复制它所需的配置块。

  2. 02

    登录一次

    在浏览器中确认 OAuth 授权；如果不想用 OAuth，也可以从密钥管理器传入一个 vxs_ 密钥。

  3. 03

    直接开口就行

    智能体会自行挑选合适的工具，并在它们之间传递 id，因此一句话就能覆盖整个流程。

Claude

网页 + 桌面端

OAuth

打开「设置 → 连接器」，添加一个名为 Voxisim 的自定义连接器，然后粘贴托管接入点。

无需配置文件 
https://api.voxisim.com/mcp

点击「连接」并在浏览器中完成登录。在对话的搜索与工具中启用 Voxisim。

智能体流程

你的智能体到底做了什么

这些工具带有类型、按用途命名，因此返回的是结构化字段，而不是智能体还要再读一遍的文字。购买可以走你的余额，也可以返回一个付款要求，由智能体用钱包完成签名。

本产品共有 9 个工具

  • sms_rental_list_services
  • sms_rental_list_countries
  • sms_rental_list_intervals
  • sms_rental_buy_number
  • sms_rental_get_codes
  • sms_rental_list_numbers
  • sms_rental_cancel
  • sms_rental_list_extend_options
  • sms_rental_extend

试着这样问你的智能体

比较 WhatsApp 在美国的实时租用时长区间，并给我看确切价格。
按可用的最短时长区间租一个号码，然后留意新消息。
列出我进行中的租用，并把最快到期的那个按一个可用时长区间续期。

REST

REST 快速上手

查询接口是公开的 —— 第一段代码你现在就能跑，无需账户。购买需要预付密钥或经过签名的 x402 付款，而两者的请求体完全相同。

两种付款方式，同一个购买调用

如果你经常购买，预付余额更简单。一次性的自主购买更适合无账户的 x402 —— 请保存首次付费响应中的 receipt_token，以便之后回查你买了什么。

1. 免费查询

无需账户。购买前先获取实时可用量和精确价格。

curl 'https://api.voxisim.com/v1/sms/rental/services'
curl 'https://api.voxisim.com/v1/sms/rental/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/rental/intervals?service_id=SERVICE_ID&country_id=COUNTRY_ID'

2A. 使用预付余额

创建一次账户，通过 x402 充值，然后用返回的 vxs_ 密钥进行购买。

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

2B. 或用 x402 无账户付款

不带凭据发送购买请求，对 402 响应中的一项要求进行签名，然后重复同一个请求。

curl -i -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

3. 获取消息

在整个租期内轮询；使用 last_id 只获取更新的消息。

curl 'https://api.voxisim.com/v1/sms/rental/numbers/YOUR_RENTAL_ID/codes' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
方法 路由 作用
GET /v1/sms/rental/services 列出可租用的服务
GET /v1/sms/rental/countries 列出某个服务可用的国家
GET /v1/sms/rental/intervals 列出时长区间和精确价格
POST /v1/sms/rental/numbers 租用一个号码
GET /v1/sms/rental/numbers 列出进行中或已归档的租用
GET /v1/sms/rental/numbers/{id}/codes 获取收到的短信
POST /v1/sms/rental/numbers/{id}/cancel 取消进行中的租用
GET /v1/sms/rental/numbers/{id}/extend-options 列出续期时长和价格
POST /v1/sms/rental/numbers/{id}/extend 为进行中的租用续期

使用要点

退款、到期与干净地恢复

到期和供应商偶发故障都是正常状态，而不是异常。请按类型化错误分支处理，重试前重新查询，并且不要假设上一次运行的价格仍然有效。

时长区间来自实时查询

时长和价格不是一份固定菜单 —— 它们来自实时的时长区间查询。购买时发送的 hours 值必须与当下真正在售的某个选项一致。

读取消息而不重复

轮询时带上 last_id，这样每次调用只返回新内容；同时保存租用 id —— 之后取消或续期都要用到它。

要取消就早点，要续期就晚点

如果不再需要这个号码，在可退款窗口内取消；或者用它当前仍可用的任一时长区间为进行中的租用续期。

出问题的时候

  • invalid_argument —— 你使用的服务、国家或时长区间已过期。重新查询并发送当前有效的组合。
  • payment_required —— 走 x402 路径时属于预期结果。签名其中一项付款要求，然后重复发送完全相同的请求。
  • number_unavailable 或冲突 —— 该选项刚刚售罄。重新查询并换一个，而不是重复同一次购买。
  • provider_unavailable 或限流 —— 退避等待，并遵循错误中给出的重试提示。立刻重试只会让情况更糟。

还没决定？

激活和租用解决的是不同问题

在能覆盖你流程的前提下，选时长最短的那个。两者的库存和价格都是实时的。

短信激活

购买一个一次性手机号，并接收它的验证码。

  • 约 20 分钟
  • 一条验证码
  • 账户验证与一次性密码流程
阅读短信激活指南

短信租用

你在这里

按你选择的时长租用一个手机号，并接收它的短信。

  • 一天起
  • 多条短信
  • 会话、测试与持续使用

租用适合的场景

多条消息的会话较长的集成测试持续的账户访问由智能体看守的收件箱

常见问题

关于租用的问题

  • 最短一天，更长的时长区间在此基础上往上走。不要假设有一份固定选项，请向时长区间接口查询你的服务和国家实际提供哪些 —— 各处不尽相同。

  • 租期内到达多少收多少。这正是它与激活的区别 —— 激活收到一条验证码就结束了。

  • 轮询时传入 last_id。这样每次调用只返回比你已有那条更新的消息，你可以放心地高频轮询，无需自己去重。

  • 可以，只要它仍处于活跃状态，用当前对它可用的任一时长区间即可。续期比重新租一个号码更便宜、干扰也更小，因为号码本身不变。

  • 在可退款窗口内取消会退还租金。超出该窗口，租用只会自然走到期满 —— 所以一旦确定用完了，就尽快取消。

  • 可以。x402 路径与激活完全一样：发送购买请求，对返回的挑战进行签名，然后重复发送完全相同的请求。

参考

自动生成的契约

这个页面讲的是流程。每个参数、每个响应字段和每个工具入参，请查阅参考文档 —— 它由线上契约生成，因此不会与实现脱节。

交互式 API在 Scalar 中浏览各项操作 REST Markdown由 OpenAPI 生成 MCP Markdown由工具元数据生成 OpenAPI JSON机器可读的契约

准备好买第一个号码了吗？

连接一个 MCP 客户端然后开口提要求，或者复制 REST 快速上手示例直接运行。

打开 API 参考 比较两个产品