API · MCP

API a MCP pro vývojáře

Stejné nástroje jako na webu — ve tvých skriptech, aplikacích a AI agentech (Claude, ChatGPT, Cursor). Jeden klíč, jeden zůstatek kreditů.

1. Klíč

Vytvoř klíč ve svém účtu → „API a MCP“. Posílej ho v hlavičce Authorization. Klíč se zobrazí jen jednou — uchovávej ho v tajných proměnných, ne v kódu.

Authorization: Bearer x2_live_…

2. Spusť úlohu

Pošli soubor metodou POST (multipart). Převodníky — /api/jobs, AI nástroje — /api/ai/jobs. Nastavení nástroje se posílá jako JSON v poli opts.

3. Získej výsledek

Zjišťuj stav, dokud nebude done nebo failed, pak stáhni soubory se stejným klíčem. Soubory uchováváme 2 hodiny.

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 pro AI agenty

Připoj X2TOOL jako MCP server — agent najde správný nástroj, spustí ho a vrátí odkaz na výsledek.

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 nástroje

search_tools
najde nástroj podle úkolu nebo formátu souboru
run_tool
spuštění: file_url nebo file_base64, nastavení, čeká na výsledek
get_job
stav dlouhé úlohy
get_balance
tarif a zbývající kredity

Limity a tarify

  • API a MCP jsou součástí tarifu Business. Free a Pro mají 20 zkušebních volání denně.
  • Převodníky kredity nestojí; AI nástroje stojí od 1 kreditu za úspěšné spuštění.
  • Velikost souboru se řídí limitem tvého tarifu; MCP přijímá soubory do 100 MB.
  • Výsledky jsou k dispozici 2 hodiny, pak se nenávratně smažou.

Chybové kódy

401 bad_api_key
chybný nebo zrušený klíč
402 no_credits
nedostatek kreditů — dobij si je
403 api_plan_required
zkušební volání na dnešek vyčerpána — je potřeba Business
413 plan_file_too_large
soubor překračuje limit tvého tarifu
429 rate_limited / daily_limit
příliš mnoho požadavků — chvíli počkej
415 unsupported_type
nástroj tento formát nepřijímá

Nástroje dostupné přes API

Serverové a AI nástroje: 893. Slug je adresa stránky nástroje.

Všechny nástroje

Máte nápad?

Chybí vám nástroj nebo bychom mohli něco zlepšit? Čteme každou zprávu.