Lewati ke konten utama
API Pengembang
Beta

Panggil 1000+ alat
dari kode Anda sendiri.

Satu endpoint REST per alat, atau satu server MCP untuk semuanya. JSON in, JSON out — dan setiap respons memberi tahu Anda berapa biayanya dan berapa sisa Anda.

1000+
endpoint yang dapat dipanggil
REST + MCP
dua permukaan, satu kunci
1,000
kredit gratis / bulan
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
}
Tiga langkah

Memulai

Tidak ada paket berbayar yang harus dibeli terlebih dahulu — paket Builder meningkatkan batas Anda, tidak membuka endpoint.

1

Buat akun gratis

Tanpa kartu kredit, tanpa panggilan penjualan. Tingkat gratis menjangkau setiap endpoint seperti yang berbayar.

2

Buat kunci API

Dari halaman akun Anda. Ditampilkan sekali — simpan di tempat yang aman.

3

Panggil alat apa pun

Respons membawa hasil, biaya, dan saldo, jadi Anda tidak perlu permintaan kedua.

Satu kunci, dua permukaan

Dua cara untuk memanggil

REST

Satu endpoint per alat

Satu POST per alat, field datar dalam body — tidak ada wrapper. Setiap skema dipublikasikan, jadi Anda dapat membuat klien, bukan menulis dengan tangan. Kegagalan adalah dokumen RFC 9457 dengan stabil code untuk dibedakan.

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" }'
Memulai →
MCP

Satu server untuk semuanya

Alat yang sama, dapat dipanggil oleh agen AI — arahkan Claude, Cursor, atau Windsurf ke endpoint MCP kami. Ini mengiklankan lima alat, tidak 1000+: agen mencari, membaca skema yang dibutuhkan, lalu menjalankannya, untuk sekitar seribu token alih-alih dua ratus ribu.

{
  "mcpServers": {
    "iotools": {
      "type": "http",
      "url": "https://mcp.iotools.cloud/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
Panduan penyetelan MCP →
Amplop yang dapat diprediksi

Setiap respons, satu bentuk

Sukses

200

Apa yang Anda minta, biayanya, dan apa yang tersisa — dalam respons yang sama, setiap kali.

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

Kegagalan

4xx / 5xx

Stabil code untuk dibedakan, bukan pesan untuk diuraikan. Panggilan yang gagal dikembalikan dananya — lihat referensi kesalahan.

{
  "type": "https://docs.iotools.cloud/errors/insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "code": "insufficient_credits",
  "request_id": "req_8f2c1b"
}
Siap untuk agen

Untuk agen AI

Agen yang belum menghafal slug membutuhkan cara untuk menemukan alat yang tepat tanpa menebak-nebak. Kedua permukaan menempati peringkat dengan pencarian yang sama, jadi agen mendapatkan jawaban yang sama — yang berubah adalah berapa banyak pekerjaan yang harus Anda jelaskan.

Melalui REST API

tiga panggilan, dijelaskan dalam prompt

Agen yang hanya memiliki alat HTTP tidak dapat menemukan katalog sendiri, jadi prompt membawa urutan: cari berdasarkan niat, baca skema slug yang dipilih, lalu panggil.

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.

Melalui server MCP

satu baris, setelah terhubung

Hubungkan server sekali dengan konfigurasi di atas dan search_tools menjadi alat seperti yang lain. Tiga panggilan REST runtuh ke dalam loop pemanggilan alat klien sendiri, jadi prompt hanya tugas.

Convert the attached CSV to JSON
using the iotools MCP server.
Gratis, dan diukur oleh apa pun selain batas laju:search_toolsdescribe_toolget_creditsget_usage

Agen pengkodean juga bisa mulai dari /llms.txt, indeks teks biasa dari situs yang dibangun untuk model bahasa.

Itu meminta sebelum dibelanjakan

Elisitasi MCP, pada setiap panggilan berbayar

Agen memilih alatnya sendiri dan memanggilnya sesering yang diinginkan — tidak ada yang tentu menghentikan loop pemanggilan alat pada jatah Anda. Jadi setiap panggilan berbayar diajukan untuk persetujuan sebelum apa pun dikenakan biaya, mengutip harganya. Klien yang mendukung elisitasi MCP menunjukkannya kepada Anda:

String Case Converter costs 3 credits. Run it?

Setiap panggilan, bukan hanya yang pertama — tidak ada "ingat ini". Prompt mendarat setelah input Anda divalidasi dan sebelum satu kredit bergerak, satu-satunya jendela di mana "tidak" adalah gratis. Bagaimana klien Anda menampilkannya terserah klien.

Accept
Berjalan, dan mengenakan biaya paling banyak harga yang dikutip — tidak pernah lebih.
Decline
Tidak ada yang berjalan, tidak ada yang dikenakan biaya, dan agen diberitahu untuk bertanya kepada Anda terlebih dahulu.
Ignore
Prompt yang ditolak atau dijatuhkan dihitung sebagai penolakan. Gagal-tutup.

Klien yang tidak dapat menunjukkan prompt terus bekerja — tetapi satu panggilan atas 50 kredit ditolak alih-alih dibelanjakan dalam diam.

Enam kategori

Jelajahi katalog

Setiap alat yang diaktifkan API duduk di salah satu dari enam kategori.

Katalog lengkap
Kredit, bukan kursi

Berapa biayanya

Menggunakan sebagian besar alat di browser Anda gratis dan tidak terbatas. Memanggilnya dari kode biaya kredit — setiap panggilan, termasuk alat yang gratis di situs. Membaca katalog tidak menelan biaya apa pun.

Akun gratis

1,000 kredit / bulan
60 permintaan per menit
Semua 1000+ endpoint
Minimum 3 kredit per panggilan
Tidak ada kartu yang diperlukan

Paket Builder

50,000 kredit / bulan
300 permintaan per menit
Minimum 1 kredit per panggilan, bukan 3
Endpoint yang sama — hanya lebih banyak ruang

Bagaimana panggilan dihargai

Panggilan biaya mana yang lebih besar: bobot alat sendiri, atau minimum rencana Anda per panggilan.

Sebagian besar katalog tidak memiliki bobot sama sekali, jadi biaya minimum — 3 pada akun gratis, 1 pada Builder.

Alat AI menelan biaya lebih banyak, karena ada tagihan vendor nyata di belakangnya.

Panggilan yang gagal gratis — kredit dikembalikan pada 4xx atau 5xx apa pun.

Bagaimana kredit bekerja →

Langkah berikutnya