PAi | API 문서

제품군과 현재 지원 범위

AI 문서 처리: 문서 분석·정보 추출은 제품 방향입니다. 메인의 분석 화면은 표시 데이터 샘플이며 전용 API 계약은 아직 없습니다.
AI 지식 검색: AIMEMO의 검색·근거 응답·인수인계 검증 화면을 소개합니다. 현재 공통 API에는 문서 색인·검색·답변 엔드포인트가 없습니다.
AI 이미지·영상: IMAGE·VIDEO 프로필과 작업·파일 API를 제공합니다. 현재 제공사는 오프라인 MOCK이며 실제 AI 생성이 아닙니다. 기존 MIO 영상 결과는 별도의 검증 자료입니다.
AI 문제 생성·교육: 학습 자료 기반 문제 생성과 교육 플랫폼 연동은 핵심 제품 방향입니다. 문항 UI는 샘플이며 문제 생성 API, 지원 문제 유형·정답·해설·난이도·문제 수 규격은 미확정입니다.

API 인증

API 서버의 /openapi.json에서 OpenAPI 3.1 계약을 제공합니다. 기본 로컬 주소는 http://localhost:4100/openapi.json입니다.

업체 키는 서버에만 보관하세요. Authorization: Bearer <platform-api-key>로 인증합니다.

작업 접수

POST /v1/jobs
Authorization: Bearer YOUR_API_KEY
Idempotency-Key: your-local-job-id
Content-Type: application/json

{
  "profile": "product-image",
  "input": {"product": {"name": "테스트 상품"}},
  "output": {"aspect_ratio": "portrait"}
}

처리와 결과

HTTP 202의 job_id로 GET /v1/jobs/{id}를 폴링하세요. SUCCEEDED 이후 결과 asset의 다운로드 URL을 발급받습니다. 같은 Idempotency-Key를 다른 입력에 재사용하면 409 충돌입니다.

샘플 프로젝트·SDK

저장소의 examples/mock-flow.ts는 원본 업로드, 이미지·영상 접수, 완료 조회, 파일 다운로드를 실행합니다. PLATFORM_API_KEY를 로컬 환경에 설정하고 pnpm sdk:example을 실행하세요.

사용량·이용 안내

현재 공개 가격표와 실제 결제는 준비되어 있지 않습니다. 사용량과 크레딧은 고객 콘솔에서 확인하세요.

크레딧은 정수 CR 단위이며 문자열로 전달합니다. 모든 생성 결과는 MOCK 테스트 결과이고 실제 AI 생성이 아닙니다.