Geliştiriciler için API ve MCP
Web sitesindeki araçların aynısı — betiklerinizde, uygulamalarınızda ve yapay zekâ ajanlarınızda (Claude, ChatGPT, Cursor). Tek anahtar, tek kredi bakiyesi.
1. Anahtar
Hesabınızda → “API ve MCP” bölümünde bir anahtar oluşturun. Anahtarı Authorization başlığında gönderin. Anahtar yalnızca bir kez gösterilir — kodda değil, gizli değişkenlerde saklayın.
Authorization: Bearer x2_live_…
2. İş başlatın
Bir dosyayı POST ile gönderin (multipart). Dönüştürücüler — /api/jobs, yapay zekâ araçları — /api/ai/jobs. Araç seçenekleri opts alanında JSON olarak gönderilir.
3. Sonucu alın
Durum done veya failed olana kadar sorgulayın, ardından dosyaları aynı anahtarla indirin. Dosyalar 2 saat saklanır.
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)Yapay zekâ ajanları için MCP
X2TOOL'u MCP sunucusu olarak bağlayın — ajan doğru aracı bulur, çalıştırır ve sonucun bağlantısını döndürür.
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 araçları
search_tools- göreve veya dosya formatına göre araç bulma
run_tool- çalıştırma: file_url veya file_base64, seçenekler; sonucu bekler
get_job- uzun süren bir işin durumu
get_balance- plan ve kalan kredi
Limitler ve planlar
- API ve MCP, Business planına dahildir. Free ve Pro planlarında günde 20 deneme çağrısı vardır.
- Dönüştürücüler kredi harcamaz; yapay zekâ araçları başarılı her çalıştırma için 1 krediden başlar.
- Dosya boyutu planınızın limitine tabidir; MCP 100 MB'a kadar dosya kabul eder.
- Sonuçlar 2 saat boyunca erişilebilir, ardından kalıcı olarak silinir.
Hata kodları
401 bad_api_key- yanlış veya iptal edilmiş anahtar
402 no_credits- yetersiz kredi — bakiye yükleyin
403 api_plan_required- bugünkü deneme çağrıları bitti — Business gerekli
413 plan_file_too_large- dosya planınızın limitini aşıyor
429 rate_limited / daily_limit- çok fazla istek — biraz bekleyin
415 unsupported_type- araç bu formatı kabul etmiyor
API ile kullanılabilen araçlar
Sunucu ve yapay zekâ araçları: 893. Slug, aracın sayfa adresidir.
pdf-to-wordword-to-pdfpdf-to-jpgcompress-pdfpdf-to-pngpowerpoint-to-pdfpdf-to-exceldjvu-to-pdfepub-to-pdfexcel-to-pdftranslate-pdfAIchat-pdfAIdelete-pdf-pagesocr-pdfAIscan-to-excelAIscan-to-wordAIsummarize-pdfAIfb2-to-pdfhtml-to-pdfpdf-to-epubpdf-to-txtextract-images-pdfextract-pdf-pagesheic-to-pdforganize-pdfpdf-extract-dataAIpdf-page-numberspdf-to-pdfapdf-to-powerpointpdf-to-quizAIpdf-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-backgroundAIupscale-imageAIheic-to-jpgcompress-image-to-sizetext-to-imageAIimage-to-textAIpng-to-icoavif-to-jpgEksik bir araç ya da daha iyi yapabileceğimiz bir şey mi var? Her mesajı okuyoruz.