三步接入
Arrakis 在與本站相同的地址上透過 HTTP 提供 MCP 服務，無需安裝任何東西。
-
為 AI 代理建立權杖
在控制台開啟 API & agents，選擇為 AI 代理建立權杖。它帶有 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 權杖。 -
交給它一個任務
告訴它機器可以執行多久，AI 代理會把它作為移除時間傳入。
在 B200 上跑我的評測：租一臺用三個小時，執行 eval.py，把結果拷回來，然後終止它。
十三個工具
每個工具在 AI 代理呼叫之前都會說明費用。出錯時會返回 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 彼此獨立。權杖無法簽發自身不具備的許可權。
按小時預付
租用時先支付第一個小時，之後每個小時開始時再扣費。餘額不足時，機器會停止。
到期時間
AI 代理權杖可以設定到期日期。權杖到期後會在所有地方同時失效。
當主機商發出通知或收回機器時
Spot 機器隨時可能被收回，任何主機商也都可能出故障。Arrakis 會立即通知你的 AI 代理。
每個結果都附帶提醒
每個 MCP 工具結果都會附帶過去一天的提醒：主機商發出的移除或維護通知、主機商無響應、機器被主機商中斷、餘額即將用完。
事件流
get_events 和 GET /v1/events 會列出每臺機器的事件：已就緒、已結束及原因，以及主機商發出的通知。
帶簽名的 webhook
在控制台的 Notifications 頁面設定一個 URL，你的 AI 代理就會實時收到每個事件，並附帶 Arrakis-Signature 簽名。
宕機期間不收費
機器的主機商無響應期間，不收取任何小時費用；主機商收回機器後才開始的每個小時，費用都會退還。
你的 AI 代理帶來客戶，你就有收益
任何人都可以加入合作伙伴計劃，AI 代理也不例外。你會獲得一個合作伙伴碼和一個連結，並從你帶來的客戶的付款中獲得分成。
一次呼叫即可加入
join_partner_program 會在你同意的前提下，為你的 AI 代理所服務的帳戶加入合作伙伴計劃，並返回合作伙伴碼、連結和一條可分享的訊息。
每筆付款都有你的分成
Arrakis 的新客戶使用你的合作伙伴碼付款，首筆付款可享受折扣。之後他們支付的所有款項，包括自動充值，你都能從中獲得分成。
只列出你的客戶
get_partner_earnings 會列出透過你的連結帶來的客戶，以及每位客戶支付的金額和為你帶來的收益，但絕不顯示他們是誰。給連結加上標籤，就能看出哪篇帖子有效果。
現金或 GPU
透過 Stripe 提現到你的銀行帳戶，或將收益轉入餘額，立即用於支付機器費用。無論在哪裡推薦 Arrakis，都要說明你會從推薦中獲得收益。
本站同樣便於 AI 代理閱讀
每個頁面都有對應的 Markdown 版本。從 llms.txt 開始吧。
可以這樣吩咐
用平常的話說即可。給出時間上限和預算，AI 代理會同時遵守。
找一塊至少 48 GB 視訊記憶體、最便宜的 GPU，租兩個小時，然後告訴我怎麼 SSH 登入。
用四塊 RTX 5090 執行 train.py 微調，最多六個小時，把檢查點拷回來，然後停止機器。
看看有沒有可用的 H200。有的話，告訴我每 GPU 小時的價格和它所在的國家。