メインコンテンツまでスキップ

出力形式

PROOFは複数の形式で結果を提供できます。主な出力は常にMarkdownで、必要に応じて他の形式に変換されます。

利用可能な形式​

形式エンドポイントパラメータ備考
Markdowntype=mdデフォルト出力、元の構造化表
CSV Basictype=csv_basicカンマ区切り値
XLSX Basictype=xlsx_basicExcelスプレッドシート（最初の変換に追加クレジット消費）
XLSX Advancedtype=xlsx_advancedフォーマット付き高度Excel（最初の変換に追加クレジット消費）
DOCXtype=docxWord文書（/convertエンドポイント使用）
PPTXtype=pptxPowerPoint（/convertエンドポイント使用）

ダウンロード vs 変換​

  • ダウンロード (GET /jobs/{id}/download?type=) — 既に生成された結果の署名付きURL返却
  • 変換 (POST /jobs/{id}/convert) — Markdown結果から新しい形式を生成

どちらを使うべきか​

  • mdとcsv_basicにはダウンロードを使用（ジョブ完了後に常に利用可能）
  • xlsx_basicにはダウンロードを使用（初回リクエスト時に自動変換、その後キャッシュ）
  • xlsx_advancedにはダウンロードを使用（初回リクエスト時に自動変換、その後キャッシュ）
  • docxとpptxには変換を使用（ダウンロードエンドポイントでは利用不可）

例: XLSX Basicダウンロード​

curl -H "X-API-Key: chu_live_xxxxxxxx" \
  "https://your-domain.com/api/v1/jobs/job-abc123/download?type=xlsx_basic"

例: DOCXに変換​

curl -X POST https://your-domain.com/api/v1/jobs/job-abc123/convert \
  -H "X-API-Key: chu_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"format": "docx"}'

署名付きURLの有効期限​

ダウンロードURLは1時間有効です。期限切れの場合は新しいURLをリクエストしてください。