API · MCP

API ja MCP kehittäjille

Samat työkalut kuin verkkosivustolla – skripteissäsi, sovelluksissasi ja tekoälyagenteissasi (Claude, ChatGPT, Cursor). Yksi avain, yksi krediittisaldo.

Hanki API-avain Hinnat

1. Avain

Luo avain tililläsi → ”API ja MCP”. Lähetä se Authorization-otsakkeessa. Avain näytetään vain kerran – säilytä se salaisuuksissa, älä koodissa.

Authorization: Bearer x2_live_…

2. Käynnistä työ

Lähetä tiedosto POST-pyynnöllä (multipart). Muuntimet – /api/jobs, tekoälytyökalut – /api/ai/jobs. Työkalun asetukset annetaan JSON-muodossa opts-kentässä.

3. Hae tulos

Kysele tilaa, kunnes se on done tai failed, ja lataa sitten tiedostot samalla avaimella. Tiedostoja säilytetään 2 tuntia.

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 tekoälyagenteille

Yhdistä X2TOOL MCP-palvelimena – agentti löytää oikean työkalun, suorittaa sen ja palauttaa linkin tulokseen.

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-työkalut

search_tools: etsi työkalu tehtävän tai tiedostomuodon mukaan
run_tool: suoritus: file_url tai file_base64, asetukset, odottaa tulosta
get_job: pitkän työn tila
get_balance: tilaus ja jäljellä olevat krediitit

Rajat ja tilaukset

API ja MCP sisältyvät Business-tilaukseen. Free ja Pro saavat 20 kokeilukutsua päivässä.
Muuntimet eivät kuluta krediittejä; tekoälytyökalut maksavat alkaen 1 krediitti onnistunutta ajoa kohden.
Tiedostokoko noudattaa tilauksesi rajaa; MCP hyväksyy enintään 100 Mt:n tiedostot.
Tulokset ovat saatavilla 2 tuntia, minkä jälkeen ne poistetaan pysyvästi.

Virhekoodit

401 bad_api_key: väärä tai peruttu avain
402 no_credits: krediitit eivät riitä – lisää krediittejä
403 api_plan_required: päivän kokeilukutsut käytetty – Business vaaditaan
413 plan_file_too_large: tiedosto ylittää tilauksesi rajan
429 rate_limited / daily_limit: liikaa pyyntöjä – odota hetki
415 unsupported_type: työkalu ei hyväksy tätä muotoa

API:n kautta saatavilla olevat työkalut

Palvelin- ja tekoälytyökaluja: 893. Slug on työkalusivun osoite.

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

Kaikki työkalut

Onko sinulla idea?

Puuttuuko työkalu tai voisimmeko tehdä jotain paremmin? Luemme jokaisen viestin.