API · MCP

API і MCP для розробників

Ті самі інструменти, що на сайті, — у ваших скриптах, застосунках та ШІ-агентах (Claude, ChatGPT, Cursor). Один ключ, один баланс кредитів.

1. Ключ

Створіть ключ у кабінеті → «API і MCP». Передавайте його в заголовку Authorization. Ключ показується один раз — зберігайте його в секретах, не в коді.

Authorization: Bearer x2_live_…

2. Запуск задачі

POST з файлом (multipart). Конвертери — /api/jobs, ШІ-інструменти — /api/ai/jobs. Параметри інструмента — JSON у полі opts.

3. Результат

Опитуйте статус, доки не буде done або failed, і завантажуйте файли з тим самим ключем. Файли зберігаються 2 години.

cURL

curl -s -H "Authorization: Bearer $X2_KEY" \
  -F "[email protected]" \
  "https://x2tool.com/api/jobs?tool=pdf-to-word"
# → {"id":"7f3c…","status":"queued"}

curl -s "https://x2tool.com/api/jobs/7f3c…"
# → {"status":"done","files":[{"name":"report.docx","url":"/api/files/7f3c…/report.docx"}]}

curl -s -H "Authorization: Bearer $X2_KEY" -o report.docx \
  "https://x2tool.com/api/files/7f3c…/report.docx"

Python

import os, time, requests

KEY = os.environ["X2_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

# ШІ / AI tool with options (no file)
job = requests.post("https://x2tool.com/api/ai/jobs?tool=translate-text", headers=H,
                    data={"opts": '{"text": "Hello!", "to": "uk"}'}).json()
while True:
    st = requests.get(f"https://x2tool.com/api/ai/jobs/{job['id']}").json()
    if st["status"] in ("done", "failed"): break
    time.sleep(1)
for f in st["files"]:
    open(f["name"], "wb").write(requests.get("https://x2tool.com" + f["url"], headers=H).content)

MCP для ШІ-агентів

Підключіть X2TOOL як MCP-сервер — агент сам знайде потрібний інструмент, запустить його і поверне посилання на результат.

https://x2tool.com/mcp · Streamable HTTP · Bearer

Claude Desktop / Cursor — mcp.json

{
  "mcpServers": {
    "x2tool": {
      "type": "http",
      "url": "https://x2tool.com/mcp",
      "headers": { "Authorization": "Bearer x2_live_…" }
    }
  }
}

Claude Code

claude mcp add --transport http x2tool https://x2tool.com/mcp \
  --header "Authorization: Bearer x2_live_…"

Інструменти MCP

search_tools
пошук інструмента за задачею або форматом
run_tool
запуск: file_url або file_base64, параметри в options, чекає результат
get_job
статус довгої задачі
get_balance
тариф і залишок кредитів

Ліміти й тарифи

  • API і MCP входять у тариф Business. На Free і Pro — 20 пробних викликів на день.
  • Конвертери не витрачають кредити; ШІ-інструменти — від 1 кредиту за успішну операцію.
  • Розмір файлу — за лімітом вашого тарифу; MCP приймає файли до 100 МБ.
  • Результати доступні 2 години, потім видаляються назавжди.

Коди помилок

401 bad_api_key
ключ неправильний або відкликаний
402 no_credits
недостатньо кредитів — поповніть баланс
403 api_plan_required
пробні виклики на сьогодні вичерпано — потрібен Business
413 plan_file_too_large
файл більший за ліміт тарифу
429 rate_limited / daily_limit
забагато запитів — зачекайте
415 unsupported_type
інструмент не приймає цей формат

Інструменти, доступні через API

893 серверних і ШІ-інструментів. Slug — це адреса сторінки інструмента.

Всі інструменти

Маєте пропозицію?

Яких інструментів бракує або що покращити? Ми читаємо кожне повідомлення.