본문으로 건너뛰기

엔드포인트별 AI 프롬프트

이 프롬프트들을 복사하여 AI 에이전트가 개별 PROOF API 엔드포인트를 호출하게 하세요.

파일 업로드​

Call the PROOF API to upload a file for table extraction.

POST https://your-domain.com/api/v1/jobs/upload
Headers: X-API-Key: <API_KEY>
Body (multipart/form-data):
  - files: <the file to upload>
  - ocr_model: premium
  - columns: <comma-separated column names, or omit for defaults>
  - prompt: <extra instructions, or omit>

Return the job_id from the response.

작업 확인​

Call the PROOF API to confirm a job and start processing.

POST https://your-domain.com/api/v1/jobs/<JOB_ID>/confirm
Headers: X-API-Key: <API_KEY>

Return the status and remaining credits.

작업 상태 확인​

Call the PROOF API to check the status of a job.

GET https://your-domain.com/api/v1/jobs/<JOB_ID>
Headers: X-API-Key: <API_KEY>

If status is "processing", report progress as done_pages/total_pages.
If status is "done", the job is complete.
If status is "error", report the error_log.

결과 다운로드​

Call the PROOF API to get the download URL for a completed job.

GET https://your-domain.com/api/v1/jobs/<JOB_ID>/download?type=xlsx_basic
Headers: X-API-Key: <API_KEY>

Return the download_url from the response.

Office 형식으로 변환​

Call the PROOF API to convert a completed job to DOCX.

POST https://your-domain.com/api/v1/jobs/<JOB_ID>/convert
Headers:
  X-API-Key: <API_KEY>
  Content-Type: application/json
Body: {"format": "docx"}

Return the download_url from the response.

계정 잔액 확인​

Call the PROOF API to check the account info and point balance.

GET https://your-domain.com/api/v1/account
Headers: X-API-Key: <API_KEY>

Report the credit balance and today's usage.

Python 자동화 스니펫​

import requests
import time

API_KEY = "chu_live_xxxxxxxx"
BASE = "https://your-domain.com/api/v1"
HEADERS = {"X-API-Key": API_KEY}

def process_file(filepath, columns=None, ocr_model="premium", output_type="xlsx_basic"):
    """전체 파이프라인: 업로드 → 확인 → 폴링 → 다운로드."""
    # 1단계: 업로드
    with open(filepath, "rb") as f:
        data = {"ocr_model": ocr_model}
        if columns:
            data["columns"] = columns
        resp = requests.post(f"{BASE}/jobs/upload", headers=HEADERS,
                             files={"files": f}, data=data)
    resp.raise_for_status()
    job_id = resp.json()["job_id"]

    # 2단계: 확인
    resp = requests.post(f"{BASE}/jobs/{job_id}/confirm", headers=HEADERS)
    resp.raise_for_status()

    # 3단계: 폴링
    while True:
        status = requests.get(f"{BASE}/jobs/{job_id}", headers=HEADERS).json()
        if status["status"] in ("done", "error"):
            break
        time.sleep(3)

    if status["status"] == "error":
        raise RuntimeError(f"작업 실패: {status.get('error_log')}")

    # 4단계: 다운로드
    url = requests.get(f"{BASE}/jobs/{job_id}/download",
                       params={"type": output_type}, headers=HEADERS).json()
    return url["download_url"]