三步接入
Arrakis 在与本站相同的地址上通过 HTTP 提供 MCP 服务，无需安装任何东西。
-
为智能体创建令牌
在控制台打开 API & agents，选择为智能体创建令牌。它带有 read 和 rent 权限、支出上限和最长租用时长。使用 CLI：
arrakis tokens create --name eval-agent \ --scope read --scope rent \ --spend-limit 50 --max-rental-hours 6 --expires-in 7d -
添加 MCP 端点
把令牌作为 Bearer 请求头使用。
通过 MCP 接入claude mcp add --transport http arrakis $ARRAKIS_URL/mcp \ --header "Authorization: Bearer ark_..."{ "mcpServers": { "arrakis": { "url": "$ARRAKIS_URL/mcp", "headers": { "Authorization": "Bearer ark_..." } } } }Transport Streamable HTTP URL $ARRAKIS_URL/mcp Header Authorization: Bearer ark_...export ARRAKIS_TOKEN=ark_... export ARRAKIS_BASE_URL=$ARRAKIS_URL arrakis mcp$ARRAKIS_URL是本站地址。请把ark_...替换为控制台中创建的 API 令牌。 -
交给它一个任务
告诉它机器可以运行多久，智能体会把它作为移除时间传入。
在 B200 上跑我的评测：租一台用三个小时，运行 eval.py，把结果拷回来，然后终止它。
十三个工具
每个工具在智能体调用之前都会说明费用。出错时会返回 API 本身的说明。
| 工具 | 功能 | 费用 |
|---|---|---|
| search_gpus | 列出可用机器，按 GPU 性能、价格和主机商的可靠性排序，最好的排在最前面；可按 GPU、数量、显存、每 GPU 小时价格和国家筛选。它会给出推荐的机器及理由。 | 免费 |
| get_market_summary | 各 GPU 系列当前的最低价格和供应量。 | 免费 |
| get_balance | 账户余额、运行中机器每小时的费用、余额何时用完，以及令牌的上限。 | 免费 |
| rent_gpu | 租用一台机器，时长最多为 termination_hours，并返回其 SSH 命令、最坏情况下的费用，以及余额可以支付多少小时。重试会返回同一台机器。 | 按小时价格逐小时计费，直到移除 |
| deploy_model | 在配置合适的机器上用 vLLM、SGLang 或 llama.cpp 部署任意 Hugging Face 模型，并返回兼容 OpenAI 的端点和 API 密钥。该机器同样提供 root SSH。 | 按小时价格逐小时计费，直到移除 |
| list_images | 机器可以启动的镜像：Arrakis 镜像，以及账户自己的镜像（包括私有镜像）。rent_gpu 也接受任意公开镜像。 | 免费 |
| list_instances | 账户中正在运行的机器。 | 免费 |
| get_instance | 单台机器的状态、SSH 命令、移除时间，以及主机商发出的任何通知。 | 免费 |
| get_events | 账户中的机器发生了什么：已就绪、已结束及原因（是否被主机商中断），以及主机商发出的通知。 | 免费 |
| terminate_instance | 立即停止机器，计费随之停止。 | 停止计费 |
| schedule_removal | 调整机器的移除时间。 | 会改变最高费用 |
| get_partner_earnings | 面向合作伙伴：你的合作伙伴码、要分享的链接和消息、你带来的客户、你已获得和可提现的收益，以及合作伙伴计划是否开放。 | 免费 |
| join_partner_program | 在账户所有者同意的前提下，为该账户加入合作伙伴计划：获得合作伙伴码、链接和一条可分享的消息。 | 免费 |
无人值守时，支出为何依然安全
这些规则内置于 API 中，因此对 MCP、CLI 和普通 HTTP 请求同样有效。
支出上限
设有上限的令牌按最坏情况（小时价格 × 到移除为止的小时数）计算每次租用，会突破上限的租用将被拒绝。
必须设置移除时间
设有上限的令牌在没有 termination_hours 时无法租用，也不能超过最长租用时长。
重试安全
相同的 idempotency_key 总是返回同一台机器，重试绝不会重复租用。
限定权限的令牌
read、rent、manage 和 billing 彼此独立。令牌无法签发自身不具备的权限。
按小时预付
租用时先支付第一个小时，之后每个小时开始时再扣费。余额不足时，机器会停止。
到期时间
智能体令牌可以设置到期日期。令牌到期后会在所有地方同时失效。
当主机商发出通知或收回机器时
Spot 机器随时可能被收回，任何主机商也都可能出故障。Arrakis 会立即通知你的智能体。
每个结果都附带提醒
每个 MCP 工具结果都会附带过去一天的提醒：主机商发出的移除或维护通知、主机商无响应、机器被主机商中断、余额即将用完。
事件流
get_events 和 GET /v1/events 会列出每台机器的事件：已就绪、已结束及原因，以及主机商发出的通知。
带签名的 webhook
在控制台的 Notifications 页面设置一个 URL，你的智能体就会实时收到每个事件，并附带 Arrakis-Signature 签名。
宕机期间不收费
机器的主机商无响应期间，不收取任何小时费用；主机商收回机器后才开始的每个小时，费用都会退还。
你的智能体带来客户，你就有收益
任何人都可以加入合作伙伴计划，AI 智能体也不例外。你会获得一个合作伙伴码和一个链接，并从你带来的客户的付款中获得分成。
一次调用即可加入
join_partner_program 会在你同意的前提下，为你的智能体所服务的账户加入合作伙伴计划，并返回合作伙伴码、链接和一条可分享的消息。
每笔付款都有你的分成
Arrakis 的新客户使用你的合作伙伴码付款，首笔付款可享受折扣。之后他们支付的所有款项，包括自动充值，你都能从中获得分成。
只列出你的客户
get_partner_earnings 会列出通过你的链接带来的客户，以及每位客户支付的金额和为你带来的收益，但绝不显示他们是谁。给链接加上标签，就能看出哪篇帖子有效果。
现金或 GPU
通过 Stripe 提现到你的银行账户，或将收益转入余额，立即用于支付机器费用。无论在哪里推荐 Arrakis，都要说明你会从推荐中获得收益。
本站同样便于智能体阅读
每个页面都有对应的 Markdown 版本。从 llms.txt 开始吧。
可以这样吩咐
用平常的话说即可。给出时间上限和预算，智能体会同时遵守。
找一块至少 48 GB 显存、最便宜的 GPU，租两个小时，然后告诉我怎么 SSH 登录。
用四块 RTX 5090 运行 train.py 微调，最多六个小时，把检查点拷回来，然后停止机器。
看看有没有可用的 H200。有的话，告诉我每 GPU 小时的价格和它所在的国家。