跳到主要内容
开发者 API
Beta

调用 1000+ 个工具
从您自己的代码

每个工具一个 REST 端点,或全部工具一个 MCP 服务器。JSON 输入,JSON 输出 — 每个响应都会告诉您花费了多少以及还剩多少。

1000+
可调用的端点
REST + MCP
两个接口,一个密钥
1,000
免费积分/月
one call, start to finish
# request
curl -X POST https://api.iotools.cloud/v1/tool/case-converter \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inputString": "hello world",
        "caseStyle": "uppercase" }'
# response
{
  "outputs": { "outputString": "HELLO WORLD" },
  "credits_used": 1,
  "credits_remaining": 999
}
三个步骤

开始使用

无需先购买付费套餐 — Builder 套餐 提升您的限制,但不会解锁新的端点。

1

创建免费账户

无需信用卡,无需销售电话。免费层级可以访问付费层级的所有端点。

2

生成 API 密钥

从您的账户页面。密钥只显示一次 — 请妥善保存。

3

调用任意工具

响应包含结果、消耗和余额,因此您无需第二次请求。

一个密钥,两个接口

两种调用方式

REST

每个工具一个端点

每个工具一个POST,字段平铺在请求体中 — 无需包装器。每个模式都已发布,所以您可以生成客户端,而无需手动编写。失败是 RFC 9457 文档,有一个稳定的code用于判断。

curl -X POST https://api.iotools.cloud/v1/tool/case-converter \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inputString": "hello world" }'
开始使用 →
MCP

一个服务器支持所有工具

相同的工具,可由 AI 智能体调用 — 将 Claude、Cursor 或 Windsurf 指向我们的 MCP 端点。它列出 5 个工具,而非 1000+ 个:智能体搜索、读取所需的模式,然后运行它,仅使用约 1000 个 token,而非 20 万个。

{
  "mcpServers": {
    "iotools": {
      "type": "http",
      "url": "https://mcp.iotools.cloud/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
MCP 设置指南 →
可预测的响应结构

每个响应,同一种结构

成功

200

您请求的内容、消耗了多少、还剩多少 — 每次都在同一个响应中。

{
  "request_id": "req_8f2c1a",
  "tool": "case-converter",
  "tool_version": "1.0.1",
  "outputs": { "outputString": "HELLO WORLD" },
  "credits_used": 1,
  "credits_remaining": 999
}

失败

4xx / 5xx

一个稳定的code用于判断,而非要解析的消息。失败的调用会退款 — 请查看错误参考

{
  "type": "https://docs.iotools.cloud/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "code": "insufficient_credits",
  "request_id": "req_8f2c1b"
}
智能体就绪

供 AI 智能体使用

没有记住工具标识的智能体需要一种方式来找到正确的工具,而无需猜测。两个接口使用相同的搜索排序,因此智能体无论哪种方式都能得到相同的答案 — 改变的是您需要明确说出多少工作。

通过 REST API

三个调用,在提示中明确说出

只有 HTTP 工具的智能体无法自己发现目录,所以提示包含序列:按意图搜索、读取它选择的工具的模式,然后调用它。

Use the IO Tools REST API to convert the attached CSV to JSON.
My key is in $IOTOOLS_KEY. Send it as
"Authorization: Bearer $IOTOOLS_KEY" on every request.

1. Find the tool — do not guess a slug:
   GET https://api.iotools.cloud/v1/tools/search?q=convert+csv+to+json&limit=5

2. Read the schema of the slug you picked:
   GET https://api.iotools.cloud/v1/tool/{slug}

3. Run it with the fields that schema declared:
   POST https://api.iotools.cloud/v1/tool/{slug}
   The fields go at the top level of the body, with no wrapper:
   { "fieldName": "…" }

Every response carries credits_used and credits_remaining,
so report what the job cost when you are done.

通过 MCP 服务器

连接后只需一行

使用上面的配置连接服务器一次,然后search_tools变成像其他任何工具一样。三个 REST 调用会折叠到客户端自己的工具调用循环中,所以提示就是任务本身。

Convert the attached CSV to JSON
using the iotools MCP server.
免费,仅由速率限制计量:search_toolsdescribe_toolget_creditsget_usage

编码智能体也可以从/llms.txt开始,一个为语言模型构建的网站的纯文本索引。

它在消耗前请求确认

MCP 引用,在每个付费调用上

智能体选择自己的工具并随意调用 — 工具调用循环中没有什么会自然停止在您的配额。所以每个付费调用在收费前都需要批准,报价。支持 MCP 引用的客户端会向您显示它:

String Case Converter costs 3 credits. Run it?

每个调用,而非仅第一个 — 没有「记住这个」。提示出现在您的输入验证后和消耗任何积分前,这是唯一「不」免费的窗口。您的客户端如何显示它取决于客户端。

Accept
运行,最多收费报价 — 绝不更多。
Decline
不运行,不收费,智能体被告知先问您。
Ignore
被消除或丢弃的提示计为拒绝。安全关闭。

无法显示提示的客户端继续运行 — 但超过 50 个积分的单个调用会被拒绝而不是无声消耗。

六个分类

浏览目录

每个启用 API 的工具都属于六个分类之一。

完整目录
按积分计费,而非按席位

费用多少

在浏览器中使用大多数工具是免费且无限的。从代码调用它们消耗积分 — 每个调用,包括网站上免费的工具。阅读目录不消耗任何积分。

免费账户

1,000 积分/月
每分钟 60 个请求
全部 1000+ 个端点
每次调用最少 3 个积分
无需信用卡

Builder 套餐

50,000 积分/月
每分钟 300 个请求
每次调用最少 1 个积分,而非 3
相同的端点 — 只是配额更大

如何计算调用成本

调用成本为以下两者中较大的:工具自身的消耗,或您套餐的每次调用最低成本。

目录中大多数工具没有消耗,所以成本为最低成本 — 免费账户 3,Builder 套餐 1。

AI 工具消耗更多,因为其背后有实际的供应商账单。

失败的调用免费 — 任何 4xx 或 5xx 错误上的积分都会退款。

积分如何运作 →

后续步骤