API · MCP

API og MCP for utviklere

De samme verktøyene som på nettsiden – i skriptene, appene og KI-agentene dine (Claude, ChatGPT, Cursor). Én nøkkel, én kredittsaldo.

1. Nøkkel

Opprett en nøkkel i kontoen din → «API og MCP». Send den i Authorization-headeren. Nøkkelen vises bare én gang – oppbevar den blant hemmeligheter, ikke i koden.

Authorization: Bearer x2_live_…

2. Start en jobb

Send en fil med POST (multipart). Konverterere – /api/jobs, KI-verktøy – /api/ai/jobs. Verktøyalternativer sendes som JSON i feltet opts.

3. Hent resultatet

Spør etter statusen til den er done eller failed, og last deretter ned filene med den samme nøkkelen. Filene lagres i 2 timer.

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 for KI-agenter

Koble til X2TOOL som en MCP-server – agenten finner riktig verktøy, kjører det og returnerer en lenke til 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-verktøy

search_tools
finn et verktøy etter oppgave eller filformat
run_tool
kjør: file_url eller file_base64, alternativer, venter på resultatet
get_job
status for en lang jobb
get_balance
plan og gjenværende kreditter

Grenser og planer

  • API og MCP er inkludert i Business-planen. Free og Pro får 20 prøvekall per dag.
  • Konverterere koster ingen kreditter; KI-verktøy koster fra 1 kreditt per vellykket kjøring.
  • Filstørrelsen følger grensen for planen din; MCP godtar filer på opptil 100 MB.
  • Resultatene er tilgjengelige i 2 timer og slettes deretter for godt.

Feilkoder

401 bad_api_key
feil eller tilbakekalt nøkkel
402 no_credits
ikke nok kreditter – fyll på
403 api_plan_required
dagens prøvekall er brukt opp – Business kreves
413 plan_file_too_large
filen overskrider grensen for planen din
429 rate_limited / daily_limit
for mange forespørsler – vent litt
415 unsupported_type
verktøyet godtar ikke dette formatet

Verktøy tilgjengelige via API

893 server- og KI-verktøy. Slug er adressen til verktøysiden.

Alle verktøy

Har du en idé?

Mangler du et verktøy, eller kan vi gjøre noe bedre? Vi leser hver melding.