API · MCP

API og MCP for udviklere

De samme værktøjer som på hjemmesiden — i dine scripts, apps og AI-agenter (Claude, ChatGPT, Cursor). Én nøgle, én kreditsaldo.

1. Nøgle

Opret en nøgle i din konto → “API og MCP”. Send den i Authorization-headeren. Nøglen vises kun én gang — gem den som en hemmelighed, ikke i koden.

Authorization: Bearer x2_live_…

2. Start et job

Send en fil med POST (multipart). Konvertere — /api/jobs, AI-værktøjer — /api/ai/jobs. Værktøjets indstillinger sendes som JSON i feltet opts.

3. Hent resultatet

Forespørg status, indtil den er done eller failed, og download derefter filerne med samme nøgle. Filer gemmes 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 til AI-agenter

Forbind X2TOOL som MCP-server — agenten finder det rette værktøj, kører det og returnerer et link 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-værktøjer

search_tools
find et værktøj ud fra opgave eller filformat
run_tool
kør: file_url eller file_base64, indstillinger, venter på resultatet
get_job
status for et langt job
get_balance
abonnement og resterende kreditter

Grænser og abonnementer

  • API og MCP er inkluderet i Business-abonnementet. Free og Pro får 20 prøvekald om dagen.
  • Konvertere koster ingen kreditter; AI-værktøjer koster fra 1 kredit pr. vellykket kørsel.
  • Filstørrelsen følger dit abonnements grænse; MCP accepterer filer op til 100 MB.
  • Resultaterne er tilgængelige i 2 timer og slettes derefter permanent.

Fejlkoder

401 bad_api_key
forkert eller tilbagekaldt nøgle
402 no_credits
ikke nok kreditter — fyld op
403 api_plan_required
dagens prøvekald er brugt — Business kræves
413 plan_file_too_large
filen overskrider dit abonnements grænse
429 rate_limited / daily_limit
for mange forespørgsler — vent lidt
415 unsupported_type
værktøjet accepterer ikke dette format

Værktøjer tilgængelige via API

893 server- og AI-værktøjer. Slug er værktøjssidens adresse.

Alle værktøjer

Har du en idé?

Mangler du et værktøj, eller kan vi gøre noget bedre? Vi læser hver besked.