文件

ParseJet 文件

ParseJet 能從任何檔案或 URL 提取文字。一個 API 呼叫即可處理 PDF、DOCX、YouTube、網頁、圖片、音訊、視訊等 25 種以上格式。

快速開始

在 60 秒內獲得您的第一個解析結果。無需註冊。

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Add your API key to requests
curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "webpage",
  "metadata": { "url": "https://example.com" }
}

身份驗證

ParseJet 提供三種存取層級。您可以立即開始使用 API，無需任何身份驗證。

核心概念

支援的格式

ParseJet 會根據檔案副檔名或 URL 模式自動偵測格式。您無需指定格式 — 只需將檔案或 URL 傳送至 /v1/parse/auto，ParseJet 會處理其餘部分。

點數

每個 API 請求會根據解析格式的複雜度消耗點數。簡單文字檔案花費 1 點數，而 YouTube 逐字稿則花費 5 點數。您的每月點數額度取決於您的方案。

輸出格式

預設情況下，ParseJet 會回傳原始擷取的文字。在任何請求中加入 ?output_format=markdown 即可取得經過後處理的輸出，包含偵測到的標題、清單、表格和程式碼區塊。

指南

解析 PDF

從任何 PDF 檔案擷取文字，包含掃描文件和多頁報告。

上傳 PDF 檔案

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

轉換為 Markdown

加入 output_format=markdown 以保留文件結構：

curl -X POST https://api.parsejet.com/v1/parse/auto/file?output_format=markdown \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

指南

YouTube 逐字稿

取得任何 YouTube 影片的完整逐字稿。支援 100 多種語言的自動生成字幕。

取得逐字稿

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID"}'

指定語言

針對非英文影片，使用 language 參數：

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "ja"}'

或使用自動偵測

/v1/parse/auto/url 端點會自動偵測 YouTube 網址：

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/VIDEO_ID"}'

指南

網頁擷取

從任何網頁擷取主要內容。ParseJet 會自動移除導覽列、廣告、側邊欄和樣板文字。

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/blog/article"}'

指南

Office 文件

解析 Word (DOCX)、Excel (XLSX)、PowerPoint (PPTX) 和 CSV 檔案。只需上傳檔案 — ParseJet 會自動偵測格式。

# Works with any Office format
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

# Also works with spreadsheets
curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

表格資料輸出為結構化 JSON

加上 output_format=json，CSV 和 Excel 的列會以物件組成的 JSON 陣列回傳——標題列作為鍵，數字保留原生型別。

curl -X POST "https://api.parsejet.com/v1/parse/auto/file?output_format=json" \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

API 參考

回應格式

所有端點都回傳相同的 JSON 結構：

{
  "text": "Extracted text content...",
  "title": "Document Title",
  "source_type": "pdf",
  "metadata": { "pages": 12, "author": "Jane Doe" }
}

推薦使用的端點。根據副檔名或 URL 類型自動偵測格式。接受 file (multipart) 或 url (表單欄位)，兩者不可同時使用。

curl -X POST https://api.parsejet.com/v1/parse/auto \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

解析任何 URL。自動區分 YouTube 影片與一般網頁。

curl -X POST https://api.parsejet.com/v1/parse/auto/url \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

解析任何上傳的檔案。根據副檔名偵測格式，若失敗則使用內容偵測。

curl -X POST https://api.parsejet.com/v1/parse/auto/file \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

從網頁擷取主要內容。移除導覽列、廣告和樣板文字。

curl -X POST https://api.parsejet.com/v1/parse/webpage \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

從 YouTube 影片擷取字幕。元資料包含 video_id、頻道和時長。

curl -X POST https://api.parsejet.com/v1/parse/youtube \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtube.com/watch?v=VIDEO_ID", "language": "en"}'

使用內建語音辨識轉錄 MP3、WAV、M4A、OGG、FLAC 或 WebM 音訊（在我們的伺服器上執行）。單次請求最多 25MB，5 分鐘音訊；回應包含轉錄文字和時間段標記。需要 3 個積分。

curl -X POST https://api.parsejet.com/v1/parse/audio \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

轉錄影片：音訊軌道將在我們的伺服器上擷取並轉錄。支援 MP4、MKV、AVI、MOV、WebM 等；單次請求最多 5 分鐘音訊。需要 5 個積分。

curl -X POST https://api.parsejet.com/v1/parse/video \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "language=en"

把影片或音訊檔案轉換成可下載的音訊檔——MP3、M4A、Opus、WAV 或 FLAC。與回傳 JSON 轉錄音軌的 /v1/parse/video 不同，這個端點直接回傳音訊本身：立體聲、完整取樣率、位元率可選。每次請求消耗 3 個點數。

curl -X POST https://api.parsejet.com/v1/convert/audio \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" \
  -F "output_format=mp3" -F "bitrate=192k" \
  -o interview.mp3

生成檔案而非純文字。pdf：將圖片和 PDF 按上傳順序合併為一個 PDF（照片轉 PDF、合併 PDF），或將單個 TXT/Markdown/HTML/Office 檔案渲染為 PDF。docx：將 Markdown、文字、HTML、PDF、Office 檔案、圖片和掃描 PDF（通過 OCR）轉換為 Word 文件。xlsx/csv：擷取 PDF、DOCX、HTML、CSV 或 XLSX 中的所有表格。png/jpg：按選定解析度渲染 PDF 頁面，或進行圖片格式轉換。回應體為檔案。每次請求 2 個積分。

# PDF tables → Excel
curl -X POST https://api.parsejet.com/v1/convert/document \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "output_format=xlsx" -o invoice.xlsx

# Photos → one PDF (upload order = page order); the same call merges PDFs
curl -X POST https://api.parsejet.com/v1/convert/document \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "[email protected]" -F "output_format=pdf" -o scan.pdf

# Markdown → Word
curl -X POST https://api.parsejet.com/v1/convert/document \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]" -F "output_format=docx" -o notes.docx

解析 EPUB 電子書。依章節擷取組織好的文字。

curl -X POST https://api.parsejet.com/v1/parse/epub \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

解析 RSS 或 Atom 摘要。也支援透過 /v1/parse/opml 解析 OPML。

curl -X POST https://api.parsejet.com/v1/parse/feed \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

使用內建 OCR 引擎從影象中擷取文字。支援 JPG、PNG、GIF、BMP、WebP、TIFF。最大 20 MB。

curl -X POST https://api.parsejet.com/v1/parse/image \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

與 /v1/parse/image 使用相同的 OCR，標記源型別「image_ocr」。/v1/parse/auto/file 自動對掃描 PDF 頁面進行 OCR。

curl -X POST https://api.parsejet.com/v1/parse/image/ocr \
  -H "Authorization: Bearer pj_YOUR_KEY" \
  -F "[email protected]"

SDKs

官方 SDKs

npm install parsejet

import { ParseJet } from "parsejet";

const client = new ParseJet({ apiKey: "pj_YOUR_KEY" });

// Parse a URL
const result = await client.parse.url("https://example.com");
console.log(result.text);

// Parse a file
const result = await client.parse.file(buffer, "report.pdf");
console.log(result.text);

// Convert a video to MP3 (3 credits)
const audio = await client.convert.audio("./interview.mov", { bitrate: "192k" });
await writeFile(audio.filename, audio.data);

pip install parsejet

from parsejet import ParseJet

client = ParseJet(api_key="pj_YOUR_KEY")

# Parse a URL
result = client.parse.url("https://example.com")
print(result.text)

# Parse a file
with open("report.pdf", "rb") as f:
    result = client.parse.file(f, "report.pdf")
    print(result.text)

# Convert a video to MP3 (3 credits)
audio = client.convert.audio("interview.mov", bitrate="192k")
audio.save()  # writes interview.mp3

AI 代理

MCP 伺服器

將 ParseJet 作為 MCP (Model Context Protocol) 伺服器，與 Claude Code、Cursor 或任何 MCP 相容的 AI 代理一起使用。

安裝

npm install -g @parsejet/mcp-server

Claude Code

新增到您專案的 .claude/settings.json 中：

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Cursor

前往 設定 → MCP Servers，新增一個伺服器：

{
  "mcpServers": {
    "parsejet": {
      "command": "npx",
      "args": ["-y", "@parsejet/mcp-server"],
      "env": {
        "PARSEJET_API_KEY": "pj_YOUR_KEY"
      }
    }
  }
}

Claude.ai (遠端)

對於 Claude.ai 網頁版，使用遠端 HTTP 端點 — 無需本地安裝：

Endpoint:  https://api.parsejet.com/mcp
Transport: Streamable HTTP
Auth:      Bearer pj_YOUR_KEY (in Authorization header)

前往 Claude.ai → 設定 → 整合 → 新增 MCP 伺服器 → 輸入上面的 URL。

可用工具

速率限制與定價

ParseJet 使用基於點數的系統。每個請求根據格式複雜度消耗點數。

回應標頭包含 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset，以及 429 回應時的 Retry-After。

錯誤代碼

所有錯誤都會返回包含 error 和 message 欄位的 JSON。