본문으로 이동

개발자 문서

인증부터 작업 접수·결과 조회까지.

현재 API 지원 범위

IMAGE·VIDEO의 오프라인 MOCK 실행만 지원합니다. 공개 예시와 기존 고객 사례는 공통 API의 현재 제공 범위와 구분합니다.

공통 엔드포인트

메서드경로용도
POST/v1/jobs작업 접수와 크레딧 예약
GET/v1/jobs/{id}현재 환경 작업 상태·결과·정산 조회
POST/v1/jobs/{id}/cancel취소 요청. 실제 완료 전 예약을 유지합니다.
GET/v1/profiles키의 허용 프로필과 입력·출력 규격 조회
POST/v1/assets/uploadsPNG·MP4 업로드 권한 발급
POST/v1/assets/{id}/complete파일 크기·형식·체크섬 확인 및 확정
GET/v1/assets/{id}/download권한 검사 후 5분 유효한 다운로드 URL 발급
PUT/v1/files/{id}서명된 권한으로 파일 업로드
GET/v1/files/{id}서명된 권한으로 비공개 파일 다운로드
GET/v1/usage현재 업체·환경 사용량과 업체 공용 잔액 조회
POST/admin/login운영자 로그인. CONSOLE_ORIGIN의 Origin 헤더 필요.
GET/admin/tenants운영자 업체·키 메타데이터·버전 조회
GET/admin/jobs운영자 최근 작업 조회

전체 계약은 실행 API 서버의 /openapi.json에서 확인합니다. 로컬 기본 주소: localhost:4100/openapi.json.