API · MCP

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.

Tüm araçlar

Bir fikrin mi var?

Eksik bir araç ya da daha iyi yapabileceğimiz bir şey mi var? Her mesajı okuyoruz.