API · MCP

API och MCP för utvecklare

Samma verktyg som på webbplatsen – i dina skript, appar och AI-agenter (Claude, ChatGPT, Cursor). En nyckel, ett kreditsaldo.

1. Nyckel

Skapa en nyckel i ditt konto → ”API och MCP”. Skicka den i Authorization-headern. Nyckeln visas bara en gång – förvara den bland dina hemligheter, inte i koden.

Authorization: Bearer x2_live_…

2. Starta ett jobb

Skicka en fil med POST (multipart). Konverterare – /api/jobs, AI-verktyg – /api/ai/jobs. Verktygsalternativ skickas som JSON i fältet opts.

3. Hämta resultatet

Fråga efter status tills den är done eller failed och ladda sedan ned filerna med samma nyckel. Filerna sparas i 2 timmar.

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 för AI-agenter

Anslut X2TOOL som MCP-server – agenten hittar rätt verktyg, kör det och returnerar en länk till resultatet.

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-verktyg

search_tools
hitta ett verktyg efter uppgift eller filformat
run_tool
kör: file_url eller file_base64, alternativ, väntar på resultatet
get_job
status för ett långt jobb
get_balance
plan och återstående krediter

Gränser och planer

  • API och MCP ingår i Business-planen. Free och Pro får 20 provanrop per dag.
  • Konverterare kostar inga krediter; AI-verktyg kostar från 1 kredit per lyckad körning.
  • Filstorleken följer din plans gräns; MCP tar emot filer på upp till 100 MB.
  • Resultaten finns tillgängliga i 2 timmar och raderas sedan permanent.

Felkoder

401 bad_api_key
fel eller återkallad nyckel
402 no_credits
inte tillräckligt med krediter – fyll på
403 api_plan_required
dagens provanrop är förbrukade – Business krävs
413 plan_file_too_large
filen överskrider din plans gräns
429 rate_limited / daily_limit
för många förfrågningar – vänta en stund
415 unsupported_type
verktyget tar inte emot det här formatet

Verktyg som finns via API

893 server- och AI-verktyg. Slug är verktygssidans adress.

Alla verktyg

Har du en idé?

Saknar du ett verktyg eller något vi kan göra bättre? Vi läser varje meddelande.