소개
사이트의 이미지·영상 생성 기능을 그대로 당신의 제품에.
이 API는 스튜디오 화면이 쓰는 것을 그대로 공개합니다. 같은 모델, 같은 과금 기준, 같은 렌더링 경로입니다. 브라우저에서 만들 수 있는 것은 키로도 만들 수 있고, 결과물은 똑같이 에셋 라이브러리에 저장됩니다.
할 수 있는 일
텍스트 / 이미지 → 이미지참조 이미지, 화면 비율, 1K/2K/4K 화질 단계 지원. 요청당 최대 4장.
텍스트 / 이미지 → 영상시작·끝 프레임, 참조 이미지, 여러 해상도 지원. 길이는 선택한 사양 범위로 조정됩니다.
모델 선택제공 중인 모델은 모두 호출 가능. 사용 가능한 id와 단가는 /v1/models 에서 확인.
크레딧 확인잔액을 언제든 조회해, 일괄 작업이 도중에 끊기는 일을 막습니다.
API 설계
형태는 OpenAI를 따릅니다. 키는 sk- 로 시작하고 Authorization: Bearer 로 전달하며, 경로는 /v1 아래에 있고, 실패 시 정해진 구조의 error 객체가 돌아옵니다. OpenAI SDK를 써봤다면 baseURL만 바꿔도 대부분 동작합니다.
이미지 생성은 동기와 비동기를 모두 지원합니다. 기본은 동기로, 이미지가 나올 때까지 기다렸다가 응답하며 형태는 OpenAI 의 images/generations 와 같습니다. 그래서 OpenAI SDK 나 중계 게이트웨이에서 호환 채널로 그대로 붙일 수 있습니다. 요청에 async: true 를 넣으면 비동기로 바뀌어 즉시 작업 id를 받고 GET /v1/tasks/{id} 로 결과를 가져옵니다.
영상 생성은 비동기뿐입니다. 렌더링이 분 단위라 동기로 기다리면 연결이 게이트웨이 타임아웃 경계에 걸리고, 타임아웃 후 재시도가 이중 과금으로 이어집니다. 배치 처리, 높은 동시성, 지연에 민감한 경우라면 이미지도 비동기를 권합니다.
모든 엔드포인트의 기본 주소: https://open.pikpikgo.com/v1