一次性激活 · REST + MCP

一个号码， 一条验证码

购买一个私有号码，接住验证码，然后继续你的事。一次激活大约存活 20 分钟 —— 如果始终没有短信到达，钱还是你的：预付余额会退回，未结算的 x402 冻结会被释放。

连接你的 AI 客户端 跳到 REST 快速上手
有效时长
约 20 分钟
你会得到
一条验证码
最适合
账户验证与一次性密码流程
800+ 覆盖的服务
200+ 有货的国家
无需注册 即可查看价格
按号码计费 从不订阅

开始接入

一分钟内拿到 API 密钥

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

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

工作方式

四个步骤，从头到尾

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

  1. 1

    查询实时库存

    先列出服务，再列出国家。可用量和精确的美元价格都是实时返回的。

    GET /v1/sms/activation/servicesGET /v1/sms/activation/countries sms_activation_list_servicessms_activation_list_countries
  2. 2

    购买一个号码

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

    POST /v1/sms/activation/numbers sms_activation_buy_number
  3. 3

    轮询获取验证码

    每隔几秒读取一次状态，直到验证码到达或该次激活结束。

    GET /v1/sms/activation/numbers/{id} sms_activation_get_code
  4. 4

    完成或获得退款

    立即使用验证码。如果在到期前没有短信到达，该次激活会自动退款。

只需配置一次

把 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。

智能体流程

你的智能体到底做了什么

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

本产品共有 5 个工具

  • sms_activation_list_services
  • sms_activation_list_countries
  • sms_activation_buy_number
  • sms_activation_get_code
  • sms_activation_list_numbers

试着这样问你的智能体

找出 WhatsApp 当前最便宜的可用国家，买一次激活，然后等待验证码。
先别买，把可用国家和 Telegram 激活的当前确切价格列给我看。
检查我进行中的短信激活，并报告已经收到的验证码。

REST

REST 快速上手

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

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

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

1. 免费查询

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

curl 'https://api.voxisim.com/v1/sms/activation/services'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_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/activation/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

2B. 或用 x402 无账户付款

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

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

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

3. 轮询获取验证码

每隔几秒轮询一次，直到 codes 非空或 done 为 true。

curl 'https://api.voxisim.com/v1/sms/activation/numbers/YOUR_ACTIVATION_ID' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
方法 路由 作用
GET /v1/sms/activation/services 列出服务及当前最便宜的可选项
GET /v1/sms/activation/countries 列出国家、库存和精确价格
POST /v1/sms/activation/numbers 购买一个一次性号码
GET /v1/sms/activation/numbers/{id} 读取状态和收到的验证码
GET /v1/sms/activation/numbers 列出进行中或已归档的激活

使用要点

退款、到期与干净地恢复

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

没有短信，就不收费

如果在大约 20 分钟的到期时间内什么都没收到，退款会自动完成。预付余额会退回，x402 授权会在从未结算的情况下被释放 —— 你无需申请。

一条验证码，用完即止

轮询直到 codes 非空或 done 为 true，然后尽快使用验证码。一次激活不会接住第二条消息；需要再试一次就重新买一个。

别把密钥写进提示词

vxs_ 密钥和 x402 的 receipt_token 属于密钥管理器 —— 不要出现在提示词、代码仓库或日志中。

出问题的时候

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

还没决定？

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

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

短信激活

你在这里

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

  • 约 20 分钟
  • 一条验证码
  • 账户验证与一次性密码流程

短信租用

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

  • 一天起
  • 多条短信
  • 会话、测试与持续使用
阅读短信租用指南

一次性激活适合的场景

一次性密码账户验证注册与 QA 自动化智能体的短时任务

常见问题

关于激活的问题

  • 从购买起大约 20 分钟。这个窗口是用来接收验证码的，而不是用来长期持有号码：一旦到期，号码就没了，也无法续期。

  • 到期时会自动退款。不需要提工单，也没有申诉流程：预付余额会退回，从未结算的 x402 授权会直接释放。

  • 不能。一次激活只对应一次验证。需要再验证一次就再买一个 —— 这也是它按验证码算最便宜的原因。

  • 通常在服务发出后几秒内，但这完全取决于对方服务，而不是我们。请每隔几秒轮询一次，而不要靠一个长时间挂起的请求等待。

  • 不要。购买前立即调用国家接口 —— 它会返回当前库存和确切价格，两者都随真实供给变化。

  • 可以。不带凭据发送购买请求，对返回的 x402 挑战进行签名，然后重复该请求。查询接口本来就不需要凭据。

参考

自动生成的契约

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

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

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

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

打开 API 参考 比较两个产品