API · MCP

API et MCP pour les développeurs

Les mêmes outils que sur le site — dans vos scripts, applications et agents IA (Claude, ChatGPT, Cursor). Une seule clé, un seul solde de crédits.

Obtenir une clé API Tarifs

1. Clé

Créez une clé dans votre compte → « API et MCP ». Envoyez-la dans l'en-tête Authorization. La clé n'est affichée qu'une fois — conservez-la dans vos secrets, pas dans le code.

Authorization: Bearer x2_live_…

2. Lancer une tâche

Envoyez un fichier en POST (multipart). Convertisseurs — /api/jobs, outils d'IA — /api/ai/jobs. Les options de l'outil sont passées en JSON dans le champ opts.

3. Récupérer le résultat

Interrogez le statut jusqu'à done ou failed, puis téléchargez les fichiers avec la même clé. Les fichiers sont conservés 2 heures.

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 pour les agents IA

Connectez X2TOOL comme serveur MCP — l'agent trouve le bon outil, l'exécute et renvoie un lien vers le résultat.

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_…"

Outils MCP

search_tools: trouver un outil par tâche ou par format de fichier
run_tool: exécution : file_url ou file_base64, options, attend le résultat
get_job: statut d'une tâche longue
get_balance: forfait et crédits restants

Limites et forfaits

L'API et le MCP sont inclus dans le forfait Business. Les forfaits Free et Pro disposent de 20 appels d'essai par jour.
Les convertisseurs ne coûtent aucun crédit ; les outils d'IA coûtent à partir de 1 crédit par exécution réussie.
La taille des fichiers suit la limite de votre forfait ; le MCP accepte des fichiers jusqu'à 100 Mo.
Les résultats sont disponibles pendant 2 heures, puis supprimés définitivement.

Codes d'erreur

401 bad_api_key: clé incorrecte ou révoquée
402 no_credits: crédits insuffisants — rechargez
403 api_plan_required: appels d'essai épuisés pour aujourd'hui — forfait Business requis
413 plan_file_too_large: le fichier dépasse la limite de votre forfait
429 rate_limited / daily_limit: trop de requêtes — patientez un peu
415 unsupported_type: l'outil n'accepte pas ce format

Outils disponibles via l'API

893 outils serveur et d'IA. Le slug correspond à l'adresse de la page de l'outil.

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

Tous les outils

Une idée ?

Un outil manque ou nous pourrions faire mieux ? Nous lisons chaque message.