레퍼런스
본문API 레퍼런스
PopNow API의 모든 엔드포인트를 한 페이지에. 전체 OpenAPI 계약 링크 포함.
기계가 읽는 전체 계약은 openapi.yaml(OpenAPI 3.1)입니다. Postman, Insomnia, 코드 생성기에 불러오거나 AI 에이전트에게 건네세요. 이 페이지는 사람이 보기 좋은 지도입니다.
- 기본 URL:
https://api.popnow.ai/api/v1(OpenAI 호환 경로:https://api.popnow.ai/v1) - 인증: 모든 요청에
Authorization: Bearer sk-popnow-… - 형식:
{ "code", "msg", "data", "request_id" },code: 200이 성공 - 금액: 정수 크레딧(
credits,maxCredits…)과 같은 금액의 미국 달러 문자열, 1크레딧 = $0.01
작업
| 메서드와 경로 | 하는 일 | 페이지 |
|---|---|---|
POST /jobs/createTask | 생성 작업 만들기(선택 ?wait=, 최대 60초) | 작업 |
GET /jobs/recordInfo?taskId= | 작업 상태와 결과 읽기 | 작업 |
GET /jobs | 이 키의 작업 목록 | 작업 |
POST /jobs/quote | 실행하지 않고 가격만 받기 | 결제 |
POST /jobs/retry | 실패·만료된 작업으로 새 작업 만들기 | 작업 |
POST /jobs/purge | 끝난 작업의 내용 삭제 | 작업 |
모델
| 메서드와 경로 | 하는 일 | 페이지 |
|---|---|---|
GET /models | 호출할 수 있는 모든 모델과 가격(?includeSchema=1로 입력 스키마 포함) | 모델 |
GET /models/{model} | 모델 하나와 입력 스키마 | 모델 |
파일과 에셋
| 메서드와 경로 | 하는 일 | 페이지 |
|---|---|---|
POST /common/upload-url | 직접 업로드용 티켓 | 미디어 |
POST /files/{fileId}/commit | 업로드를 마치고 popnow:// URI 받기 | 미디어 |
POST /files/import | 링크에서 LoRA 파일 가져오기 | 에셋 |
POST /common/download-url | 작업 결과물의 새 서명 링크 | 미디어 |
GET /assets, POST /assets | 에셋 목록 또는 저장 | 에셋 |
GET, PATCH, DELETE /assets/{assetId} | 에셋 하나 읽기·이름 바꾸기·삭제 | 에셋 |
GET /assets/entities | 내 캐릭터 | 에셋 |
GET /assets/usage | 저장 플랜과 사용량 | 에셋 |
계정
OpenAI Videos 호환(/v1)
| 메서드와 경로 | 하는 일 | 페이지 |
|---|---|---|
POST /v1/videos | 영상 작업 만들기 | OpenAI Videos |
GET /v1/videos/{id} | 읽기 | OpenAI Videos |
GET /v1/videos/{id}/content | 파일로 리디렉션 | OpenAI Videos |
GET /v1/models | OpenAI 형식의 모델 목록 | OpenAI Videos |