使用手册

本手册面向第一次使用 JarvisClaw 的用户，从注册一路讲到把平台接进你自己的程序。只看前六章就能跑通第一次调用，大约十分钟。后面几章是进阶能力，用得上再看。

控制台地址：https://api.jarvisclaw.ai 文档中心：https://docs.jarvisclaw.ai

手册中的截图来自真实控制台界面，其中的余额与用量数字已做遮盖处理，你看到的界面会显示你自己的数据。

一、这个平台能帮你做什么

用一句话说：一把钥匙、一个接口地址，调用平台上所有的 AI 能力和 API，用多少算多少。

五个特色

1. 一把钥匙通吃 对话、图像、音频、视频、向量、重排、搜索，还有 API 市场里的各类接口，全部用同一把 sk- 开头的钥匙。不用为每个能力单独申请账号、单独接一套鉴权。

2. 代码基本不用改 我们同时提供 OpenAI 协议与 Anthropic 协议的原生接口，两套都是官方原样的请求和响应格式。你原来的程序怎么写的，改一下接口地址就能接过来。Gemini 协议也支持。

3. 按调用量结算 没有月费，没有订阅套餐，没有起步价。账户有余额就能用，用完再充。想停就停，不会有后续费用。

4. 支持链上充值 除了常规在线支付，还支持 USDC 稳定币充值，Base 与 Solana 双链。链上到账后余额自动更新，不需要人工审核。

5. 为 AI 智能体设计 除了给人写代码用的接口，平台还提供两套让智能体自己发现和调用能力的通道：AIP（意图协议）与 MCP（模型上下文协议）。智能体可以自己查有什么能力、自己估算开销、自己带预算上限执行任务。第八、九章详细讲。

三块常用功能

	是什么	在哪
AI 模型调用	主流对话、图像、音频、视频模型	直接调接口
API 市场	预测市场、网页搜索、链上数据、媒体生成等现成 API	API Marketplace 页
账户与账单	钱包、充值、调用记录、费用汇总	Wallet 等页面

二、第一步：注册与登录

打开 https://api.jarvisclaw.ai。
点击右上角的 Console（控制台）。
没有账号就选 Sign up 注册，填邮箱和密码即可；已有账号选 Sign in 登录。
登录后会进入控制台首页。

界面默认是英文，右上角的 EN 可以切换语言。旁边还有主题切换（浅色／深色），按自己习惯选。

顶部导航栏

图 1　顶部导航栏：主要功能都从这里进

顶部这排入口对应平台的几大块：API Marketplace（接口市场）、Model Gateway（模型网关）、Agent Intent Protocol（智能体意图协议）、Machine-to-Machine（机器对机器）、Docs（文档）。右侧会实时显示你的 USDC 余额。

三、第二步：看懂钱包页面

登录后打开 Wallet（钱包）页，这是你最常回来的一页。

钱包总览

图 2　钱包页顶部的三张卡片

三张卡片分别告诉你：

卡片	含义
WALLET BALANCE	账户当前可用余额。余额不足时这里会出现提示图标。
USAGE	最近 30 天的实际消费金额。
API REQUESTS	最近 30 天的调用次数。

顶部导航栏也会常驻显示你的余额，方便随时瞄一眼。

建议：第一次使用时先看一眼余额。余额为零时调用会被拒绝，这是最常见的"为什么调不通"。

四、第三步：给账户充值

JarvisClaw 有两种充值方式，都在 Wallet 页，选一种就行。

方式一：在线支付

还在 Wallet 页，往下滚动就能看到充值区域。

充值区域

图 3　Online Payment 充值区

在 AMOUNT 里点一个金额档位，或者在 CUSTOM AMOUNT 里自己填一个数字。
选择支付方式。页面会显示当前开放的渠道。
按页面提示完成付款。

付款成功后余额会自动更新。如果没有立刻变化，刷新一下页面即可。

方式二：USDC 稳定币充值

如果你习惯用链上资产，可以直接转 USDC。点充值区的 Crypto Deposit（链上充值）。

Crypto Deposit 弹窗

图 4　Crypto Deposit 弹窗：两条链各一个专属地址（图中地址已打码，请用你自己页面上的真实地址）

弹窗里会给你两个专属收款地址，都是你账户独有的，可以长期使用：

链	收什么	注意
Base	USDC（EVM 标准）	只转 Base 链上的 USDC
Solana	USDC（SPL 标准）	只转 Solana 链上的 USDC

操作步骤：

选择你要用的链（Base 或 Solana）。
复制对应的收款地址，或直接扫二维码。
从你的钱包／交易所转出 USDC 到这个地址。
弹窗里能看到实时状态：Confirming（链上确认中）→ Settling（入账中）→ 完成。到账后余额自动更新。

三条一定要注意：

只转 USDC，且必须是所选链上的 USDC。转其他币种或转错链，资产无法找回。
每笔有最低充值金额，弹窗里的 Min 会标明当前值。低于这个数不会入账。
地址是你的专属地址，转多次都可以，不用每次重新获取。

充值记录可以点 Order History（订单历史）或弹窗内的历史列表查看，每一笔都有记录。

五、第四步：创建你的钥匙（API Key）

这是把平台接进你自己程序的唯一一步。打开左上角菜单里的 API Keys 页面，或直接访问 https://api.jarvisclaw.ai/en/keys。

API Keys 页面

图 5　API Keys 列表与创建入口

点右上角 + Create API Key。
给它起个名字，方便日后分辨（比如 我的测试、线上服务）。
创建后立即复制并保存好这串钥匙。它以 sk- 开头，列表里只会显示前后几位，中间是打码的，不会再次完整展示。
一把钥匙就够用了。想给不同项目分开记账，可以多建几把。

关于安全，三条一定要记住：

钥匙等于你的账户凭证，谁拿到都能花你的余额。
不要写在前端网页代码里，不要提交到 Git 仓库，不要发在群里或截图里。
万一泄露，回到这一页把它停用（Status 切换）或删掉，再建一把新的。

六、第五步：调用 AI 模型

所有接口的鉴权方式都一样：请求头带上 Authorization: Bearer 你的钥匙。

模型名去 Models（模型列表）页查，页面上会标出每个模型来自哪个厂商、支持什么能力、当前是否可用。

模型列表

图 6　Models 页：模型名、厂商、能力标签、状态

复制这一页 Model 列里的完整名称（形如 厂商/模型名），填进下面请求里的 model 字段即可。

6.1 用 OpenAI 协议（最常用）

接口地址 https://api.jarvisclaw.ai/v1/chat/completions，请求体就是标准写法。

bash

curl https://api.jarvisclaw.ai/v1/chat/completions \
  -H "Authorization: Bearer 你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型名",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

在 Python 里：

python

from openai import OpenAI

client = OpenAI(
    api_key="你的钥匙",
    base_url="https://api.jarvisclaw.ai/v1",
)

resp = client.chat.completions.create(
    model="模型名",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(resp.choices[0].message.content)

关键就一句话：把接口地址换成 https://api.jarvisclaw.ai/v1，把钥匙换成平台给你的，其余代码照旧。

流式输出加 "stream": true 即可，行为与你熟悉的一致。

6.2 用 Anthropic 协议

我们同样提供 Anthropic 协议的原生接口，地址 https://api.jarvisclaw.ai/v1/messages。如果你的程序原本按那套协议写的，直接把地址和钥匙换过来就行。

bash

curl https://api.jarvisclaw.ai/v1/messages \
  -H "Authorization: Bearer 你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型名",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

请求体和返回体都是该协议的原样格式，不需要做字段转换。

6.3 其他能力接口

不只是对话，常用的能力都有对应接口，鉴权方式完全相同：

你想做什么	接口路径
对话补全	`/v1/chat/completions`
Anthropic 协议对话	`/v1/messages`
文本向量化	`/v1/embeddings`
生成图片	`/v1/images/generations`
文字转语音	`/v1/audio/speech`
语音转文字	`/v1/audio/transcriptions`
生成视频	`/v1/videos/generations`
结果重排	`/v1/rerank`
联网搜索	`/v1/search`
实时语音对话	`/v1/realtime`（WebSocket）
查可用模型列表	`/v1/models`

Gemini 协议的接口在 /v1beta 下，用法与该协议官方一致。

查模型名：控制台的模型列表页可以直接复制，也可以用接口拿：

bash

curl https://api.jarvisclaw.ai/v1/models \
  -H "Authorization: Bearer 你的钥匙"

七、逛 API 市场，以及怎么调用

除了 AI 模型，平台还汇集了两千多个现成的 API 服务，覆盖网页搜索、链上数据、图像与视频生成、代码工具、域名解析、天气航空等方向，用同一把钥匙就能调，不用去别处注册账号。

API 市场

图 7　API Marketplace 首页

7.1 先找到你要的接口

打开 https://api.jarvisclaw.ai/en/marketplace，按分类浏览。每个接口都标了状态、请求方式和参数说明，点进去能看到示例。

也可以用接口搜，不需要登录：

bash

# 按关键词搜
curl "https://api.jarvisclaw.ai/api/marketplace/apis?q=weather&page_size=5"

# 按分类翻页浏览
curl "https://api.jarvisclaw.ai/api/marketplace/apis?category=video&page=1&page_size=20"

四个参数：q 关键词、category 分类、page 页码、page_size 每页条数。写错的参数名会被忽略、返回默认结果，所以搜不动的时候先检查拼写。

返回的 data.items 里，每一项这三个字段是调用时要用的：

字段	用途
`resource_id`	数字编号，调用时填它
`slug`	可读名称，也能直接用来调用
`method`	这个接口的请求方式

data.total 是命中总数，data.categories 会列出所有分类和各自的接口数量，方便你先看看有哪些方向。

7.2 调用市场里的接口

拿到接口信息后，都是通过平台统一转发，鉴权还是那把钥匙。两种写法，覆盖市场里的全部服务。

写法一：按编号或名称调用（市场里两千多个接口都用这种）

bash

# 用 resource_id
curl "https://api.jarvisclaw.ai/v1/marketplace/api/3621" \
  -H "Authorization: Bearer 你的钥匙"

# 用 slug，效果完全一样
curl "https://api.jarvisclaw.ai/v1/marketplace/api/aviation-metar" \
  -H "Authorization: Bearer 你的钥匙"

需要传参数的接口，把参数放进 JSON 请求体，字段名照详情页写：

bash

curl -X POST "https://api.jarvisclaw.ai/v1/marketplace/api/city-weather" \
  -H "Authorization: Bearer 你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{"参数名":"参数值"}'

这种写法不用操心请求方式——平台知道每个接口该怎么发，会照它的要求转发出去。

写法二：按服务名与路径调用（平台自营的几组服务，路径更直观）

bash

curl "https://api.jarvisclaw.ai/v1/marketplace/服务名/接口路径?参数=值" \
  -H "Authorization: Bearer 你的钥匙"

比如查预测市场行情：

bash

curl "https://api.jarvisclaw.ai/v1/marketplace/prediction/markets/search?q=bitcoin" \
  -H "Authorization: Bearer 你的钥匙"

这一类服务名对应一组接口，具体有哪些路径、用哪个请求方式，看详情页给的那一个照着写。

两个容易踩的坑

编号要填纯数字或纯 slug。列表里如果给的是带斜杠的完整标识，只取斜杠后面那段，整段粘进地址会多出一层路径，直接 404。
用写法二时，服务名必须是详情页上真实存在的那个，拼错会返回 404 并告诉你没找到这个服务。

不确定某个接口收什么参数，除了看详情页，也可以用第九章的 MCP 工具 get_api_detail 查它的完整说明。

想了解计费方式，可以看 https://api.jarvisclaw.ai/en/pricing。

八、AIP：让智能体自己找能力

如果你在做 AI 智能体，AIP（Agent Intent Protocol，意图协议）能省掉大量硬编码。核心想法是：你的智能体只说"我想做什么"，平台负责找出该用哪个能力、怎么调。

8.1 智能体自动发现

平台在固定位置发布了一份能力自描述文档，任何智能体抓一次就知道该怎么对接：

bash

curl https://api.jarvisclaw.ai/.well-known/agent-intent-protocol.json

8.2 有哪些任务类型

不需要登录就能查：

bash

curl https://api.jarvisclaw.ai/v1/intent/types

当前覆盖二十多类，包括对话、图像生成、视频生成、语音合成、翻译、网页搜索、知识检索、地理、区块链、数据分析、存储、提示词优化等。

8.3 常用接口

做什么	接口
查有哪些任务类型	`GET /v1/intent/types`
试算某个意图会怎么路由	`GET /v1/intent/resolve`
发现可用能力	`GET /v1/intent/discover`
把一句自然语言解析成意图	`POST /v1/intent/resolve/natural`
预估开销	用 MCP 的 `aip_estimate_cost` 工具，见第九章
执行一个意图	`POST /v1/intent/execute`
带预算上限执行	`POST /v1/intent/execute-budget`
订阅／查订阅／退订	`POST`、`GET`、`DELETE /v1/intent/subscribe`
查执行审计记录	`GET /v1/intent/audit`

举个例子，让平台把一句话解析成结构化意图：

bash

curl -X POST https://api.jarvisclaw.ai/v1/intent/resolve/natural \
  -H "Authorization: Bearer 你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{"query": "帮我把这段中文翻译成日文"}'

返回里会给出候选意图和置信度，你的智能体据此决定下一步。

8.4 执行时可以设预算上限

普通执行用 POST /v1/intent/execute。如果想加一道保险，用 POST /v1/intent/execute-budget，可以带上这次任务的预算上限，超出上限就不执行。

对无人值守的智能体很有用——不会因为一个循环把余额跑光。配合前面的开销预估，整套流程是：先估、再定上限、再执行。

8.5 智能体也能直接用市场里的接口

第七章介绍的两千多个市场接口，智能体不需要额外配置就能用：先用目录接口按关键词搜到 resource_id，再调 /v1/marketplace/api/{resource_id}，鉴权仍然是同一把钥匙。搜索这一步不需要登录，所以智能体可以先自行探索有什么能力可用，再决定调哪个。

九、MCP：把平台接进你的 AI 客户端

MCP（Model Context Protocol）是给 AI 客户端和智能体框架用的标准接口。配好之后，你的 AI 助手可以直接使用平台能力，不用你写胶水代码。

9.1 接入信息

项目	值
接口地址	`https://api.jarvisclaw.ai/mcp`
调用方式	`POST`（JSON-RPC）／`GET`（SSE 长连接）
鉴权	请求头 `Authorization: Bearer 你的钥匙`
协议版本	`2025-03-26`

握手示例：

bash

curl -X POST https://api.jarvisclaw.ai/mcp \
  -H "Authorization: Bearer 你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

列出全部可用工具：

bash

curl -X POST https://api.jarvisclaw.ai/mcp \
  -H "Authorization: Bearer 你的钥匙" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

9.2 平台提供的工具

工具名	作用
`list_models`	列出平台上所有可用模型
`chat`	向任意模型发起一次对话
`search_apis`	在 API 市场里搜接口
`get_api_detail`	查某个接口的详细说明与参数
`discover_agents`	发现平台上其他可用的智能体
`aip_list_intents`	列出所有可路由的任务类型
`aip_resolve`	把一个意图解析成具体执行方案
`aip_estimate_cost`	执行前预估这个任务的开销
`aip_execute_with_budget`	带预算上限执行任务

后四个是给智能体做自主决策的：先列任务类型、再解析、再估开销、最后带上限执行。整条链路不需要你介入。

9.3 自建接口接入

如果你有自己的 API 想挂到平台上，用同一套鉴权和计费对外提供，可以在控制台注册后通过 /v1/uapi/你的标识/接口路径 访问。具体配置方式见文档中心。

十、日常会用到的几个页面

控制台左侧这排菜单就是日常入口，分四组：PLATFORM（平台）看总览和模型，AGENTS（智能体）逛市场，DEVELOP（开发）管钥匙和文档，BILLING（账务）管钱和用量。

控制台侧边栏

图 8　普通账号登录后的左侧菜单（原图为竖排一列，此处拆成两栏便于排版）

你想做什么	去哪	所在分组
看账户总览	Overview 总览	PLATFORM
看模型清单和价目	Models 模型	PLATFORM
接 MCP 客户端	MCP Server	PLATFORM
改密码、改资料	Profile 个人资料	PLATFORM
找现成的 API	Marketplace 市场	AGENTS
管理钥匙	API Keys	DEVELOP
查完整技术文档	Docs 文档	DEVELOP
看余额、充值	Payments 付款（点进去页面标题写的是 Wallet，同一页）	BILLING
查每一次调用的明细	Usage 用量	BILLING
看花了多少钱	My Costs 费用	BILLING
拿月度账单、发票	My Invoices 发票	BILLING
查佣金、拿邀请链接	Rebate 返佣	BILLING

两个页面点进去比名字上写的多一些东西，先说清楚免得找不到：

My Invoices 分上下两块。上半是 Billing Details（开票资料）——公司法定名称、税号、收账单的邮箱、地址、以及给你们财务系统用的 PO 号。这块要先填好再保存，因为每张发票是在开出的那一刻把当时的资料抄一份存进去的，之后再改只影响以后的发票，已经开出的不会跟着变。下半是发票列表（发票号、账期、金额、请求数、开出日期）。发票在每个自然月结束之后才生成，所以新账号刚开通时这里是空的，属正常。

Rebate 页面标题写的是 Commission Center（佣金中心），里面两个页签：Platform Commission（平台佣金）看平台活动给你的佣金和发放记录；Referral Commission（邀请佣金）里有你自己的邀请码和邀请链接，把链接发给别人注册即可，同页还能按月份查你邀请来的用户和发放记录。佣金一律发到你的平台钱包余额里。两块的费率和活动都由平台按月单独设定、不是固定值，平台也可能调整或暂停，所以页面上看到 Plan Status: Paused（暂停）只说明当期没有在跑的方案，不是你的账号有问题。

以上是普通账号能看到的全部入口。如果你登录后侧栏比这多出 FINANCE、OPERATIONS、GROWTH、SYSTEM 四组，或者 BILLING 组里多了 Recharge、Referral Payouts 两项，说明你这个账号带管理员权限。那些页面是给平台运维用的——管渠道、看全平台成本、审用户、改系统设置——和你自己调用 API、充值、看账单没关系，日常用不到，本手册也不涉及。普通账号点不到它们，看不到就是正常的。

十一、遇到问题先看这里

调用返回未授权 / 401 钥匙填错了，或者前面漏了 Bearer 。回到 API Keys 页确认钥匙状态是 Enabled。

提示余额不足 去 Wallet 页充值。充完刷新页面确认余额已更新。

在线付款成功但余额没变 先刷新页面。仍未更新的话，到 Order History 确认订单状态，再联系我们。

转了 USDC 但没到账 先确认三件事：转的是不是 USDC、链选得对不对（Base 的地址只收 Base）、金额有没有达到弹窗里标注的最低值。都没问题就等链上确认完成，弹窗里能看到 Confirming／Settling 状态。

不知道该填哪个模型名 控制台的模型列表页有全部可用模型，或者调 /v1/models 拿一份，直接复制名字填进 model 字段。

调市场接口返回 404 八成是请求方式用错了。回接口详情页确认它要的是 GET 还是 POST，路径也照抄。

想知道钱花在哪了Usage 有每一次调用的记录，My Costs 是汇总视图。

十二、几条省心的建议

先用小额充值跑通全流程，确认无误再加量。
给钥匙起有意义的名字，不同项目分开建，出问题时好定位。
钥匙放环境变量，不要硬编码在代码里。
上线前去 Usage 页看一眼真实消耗，对量级有个概念。
做无人值守的智能体，用 AIP 的预算上限，避免意外跑量。
链上充值第一次先转一笔小额，确认地址和链都对了再转大额。

需要帮助随时联系我们。更详细的接口说明、各语言示例和进阶用法，都在 https://docs.jarvisclaw.ai。

本页英文版：/guide。

使用手册 ​

一、这个平台能帮你做什么 ​

五个特色 ​

三块常用功能 ​

二、第一步：注册与登录 ​

三、第二步：看懂钱包页面 ​

四、第三步：给账户充值 ​

方式一：在线支付 ​

方式二：USDC 稳定币充值 ​

五、第四步：创建你的钥匙（API Key） ​

六、第五步：调用 AI 模型 ​

6.1 用 OpenAI 协议（最常用） ​

6.2 用 Anthropic 协议 ​

6.3 其他能力接口 ​

七、逛 API 市场，以及怎么调用 ​

7.1 先找到你要的接口 ​

7.2 调用市场里的接口 ​

八、AIP：让智能体自己找能力 ​

8.1 智能体自动发现 ​

8.2 有哪些任务类型 ​

8.3 常用接口 ​

8.4 执行时可以设预算上限 ​

8.5 智能体也能直接用市场里的接口 ​

九、MCP：把平台接进你的 AI 客户端 ​

9.1 接入信息 ​

9.2 平台提供的工具 ​

9.3 自建接口接入 ​

十、日常会用到的几个页面 ​

十一、遇到问题先看这里 ​

十二、几条省心的建议 ​

使用手册

一、这个平台能帮你做什么

五个特色

三块常用功能

二、第一步：注册与登录

三、第二步：看懂钱包页面

四、第三步：给账户充值

方式一：在线支付

方式二：USDC 稳定币充值

五、第四步：创建你的钥匙（API Key）

六、第五步：调用 AI 模型

6.1 用 OpenAI 协议（最常用）

6.2 用 Anthropic 协议

6.3 其他能力接口

七、逛 API 市场，以及怎么调用

7.1 先找到你要的接口

7.2 调用市场里的接口

八、AIP：让智能体自己找能力

8.1 智能体自动发现

8.2 有哪些任务类型

8.3 常用接口

8.4 执行时可以设预算上限

8.5 智能体也能直接用市场里的接口

九、MCP：把平台接进你的 AI 客户端

9.1 接入信息

9.2 平台提供的工具

9.3 自建接口接入

十、日常会用到的几个页面

十一、遇到问题先看这里

十二、几条省心的建议