API · MCP

API & MCP für Entwickler

Dieselben Tools wie auf der Website — in Ihren Skripten, Apps und KI-Agenten (Claude, ChatGPT, Cursor). Ein Schlüssel, ein Credit-Guthaben.

API-Schlüssel erhalten Preise

1. Schlüssel

Erstellen Sie einen Schlüssel in Ihrem Konto → „API & MCP“. Senden Sie ihn im Authorization-Header. Der Schlüssel wird nur einmal angezeigt — bewahren Sie ihn in Secrets auf, nicht im Code.

Authorization: Bearer x2_live_…

2. Job starten

Senden Sie eine Datei per POST (multipart). Konverter — /api/jobs, KI-Tools — /api/ai/jobs. Tool-Optionen werden als JSON im Feld opts übergeben.

3. Ergebnis abrufen

Fragen Sie den Status ab, bis er done oder failed lautet, und laden Sie die Dateien dann mit demselben Schlüssel herunter. Dateien werden 2 Stunden gespeichert.

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 KI-Agenten

Binden Sie X2TOOL als MCP-Server ein — der Agent findet das passende Tool, führt es aus und gibt einen Link zum Ergebnis zurück.

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

search_tools: Tool nach Aufgabe oder Dateiformat finden
run_tool: ausführen: file_url oder file_base64, Optionen, wartet auf das Ergebnis
get_job: Status eines langen Jobs
get_balance: Plan und verbleibende Credits

Limits & Pläne

API und MCP sind im Business-Plan enthalten. Free und Pro erhalten 20 Testaufrufe pro Tag.
Konverter kosten keine Credits; KI-Tools kosten ab 1 Credit pro erfolgreichem Durchlauf.
Die Dateigröße richtet sich nach dem Limit Ihres Plans; MCP akzeptiert Dateien bis 100 MB.
Ergebnisse sind 2 Stunden verfügbar und werden danach endgültig gelöscht.

Fehlercodes

401 bad_api_key: falscher oder widerrufener Schlüssel
402 no_credits: nicht genügend Credits — bitte aufladen
403 api_plan_required: Testaufrufe für heute aufgebraucht — Business erforderlich
413 plan_file_too_large: Datei überschreitet das Limit Ihres Plans
429 rate_limited / daily_limit: zu viele Anfragen — bitte kurz warten
415 unsupported_type: das Tool akzeptiert dieses Format nicht

Per API verfügbare Tools

893 Server- und KI-Tools. Der Slug ist die Adresse der Tool-Seite.

pdf-to-wordword-to-pdfpdf-to-jpgcompress-pdfpdf-to-pngpowerpoint-to-pdfpdf-to-exceldjvu-to-pdfepub-to-pdfexcel-to-pdftranslate-pdfAI chat-pdfAI delete-pdf-pagesocr-pdfAI scan-to-excelAI scan-to-wordAI summarize-pdfAI fb2-to-pdfhtml-to-pdfpdf-to-epubpdf-to-txtextract-images-pdfextract-pdf-pagesheic-to-pdforganize-pdfpdf-extract-dataAI pdf-page-numberspdf-to-pdfapdf-to-powerpointpdf-to-quizAI pdf-to-svgprotect-pdfredact-pdfrepair-pdftxt-to-pdfunlock-pdfurl-to-pdfwatermark-pdfwebp-to-pdfazw3-to-pdfcrop-pdfflatten-pdfgrayscale-pdfmarkdown-to-pdfmobi-to-pdfodt-to-pdfpdf-n-uppdf-to-azw3pdf-to-bookletpdf-to-fb2pdf-to-htmlpdf-to-markdownpdf-to-mobipdf-to-odtpdf-to-rtfpdf-to-tiffpdf-to-webpremove-pdf-metadatartf-to-pdftiff-to-pdfxps-to-pdfdoc-to-docxfb2-to-epubepub-to-fb2epub-to-mobimobi-to-epubazw3-to-epubazw3-to-fb2azw3-to-mobidocx-to-epubdocx-to-txtepub-to-azw3fb2-to-azw3fb2-to-mobimarkdown-to-docxmobi-to-azw3mobi-to-fb2odt-to-docxppt-to-pptxpptx-to-jpgcompress-pptxdjvu-to-epubdjvu-to-jpgdoc-to-odtdoc-to-rtfdoc-to-txtdocx-to-docdocx-to-htmldocx-to-jpgdocx-to-markdowndocx-to-odtdocx-to-rtfepub-to-docxepub-to-txtfb2-to-txthtml-to-docxkeynote-to-pptxmerge-wordodp-to-pptxodt-to-docodt-to-rtfodt-to-txtpages-to-docxpptx-to-videortf-to-docrtf-to-docxrtf-to-odtrtf-to-txttxt-to-doctxt-to-docxtxt-to-odttxt-to-rtfremove-backgroundAI upscale-imageAI heic-to-jpgcompress-image-to-sizetext-to-imageAI image-to-textAI png-to-icoavif-to-jpg

Alle Tools

Eine Idee?

Fehlt ein Tool oder können wir etwas besser machen? Wir lesen jede Nachricht.