PixAI API 문서
PixAI API 개발자 문서. REST API, API 키 인증, 비동기 작업, Webhook으로 애니메이션 스타일 AI 이미지를 프로그램에서 생성할 수 있습니다. 빠른 시작으로 시작한 뒤 v2 / v1 엔드포인트 참조로 이동하세요.
PixAI API를 사용하면 pixai.art와 동일한 모델(Tsubaki.2, Haruka v2, Hoshino v2 등)로 애니메이션 스타일의 AI 아트를 애플리케이션에서 생성할 수 있습니다. https://api.pixai.art에서 제공되는 REST API로, API 키로 인증하고 생성 작업을 제출한 뒤 작업이 완료되면 이미지를 가져오는 방식입니다.
API 동작 방식
- API 키 받기. PixAI API 팀에 신청하거나 PixAI 프로필에서 키를 만든 뒤, 모든 요청에
Authorization: Bearer <key>헤더를 보냅니다. 자세한 내용은 PixAI API 사용 방법을 참고하세요. - 작업 만들기. 프롬프트, 모델, 화면 비율이나 스타일 같은 선택 설정을
POST /v2/image/create로 보내면waiting상태의 작업이 반환됩니다. - 완료 기다리기.
GET /v1/task/{taskId}를 1.5초에 한 번 이하로 폴링하거나, Webhook을 등록해 완료 시 작업 객체를 받습니다. - 이미지 다운로드. 완료된 작업에는 미디어 URL이 포함됩니다.
GET /v1/media/{mediaId}는 미디어 정보를,GET /v1/media/{mediaId}/image는 파일로 리디렉션을 반환합니다. 생성물은 무기한 보관되지 않으므로 필요한 파일은 저장해 두세요.
문서 둘러보기
빠른 시작
API 액세스 받기, 첫 요청 보내기, 현재 제한 사항.
이미지 생성 (API v2)
화면 비율, 모드, 스타일 프리셋을 포함한 POST /v2/image/create 참조.
작업과 미디어 (API v1)
작업 상태 조회, 미디어 조회 및 업로드.
모델
사용 가능한 이미지 모델의 ID, 버전, 샘플링 방법.
지원 해상도
화면 비율과 해상도 등급별 출력 크기.
Webhook
폴링 대신 POST로 작업 상태 업데이트 받기.
제한 사항
동시 실행 한도, 폴링 권장 간격, API에서 아직 지원하지 않는 기능.
FAQ
이메일과 멤버십으로 키를 받는 방식의 차이, 점검 안내, API 생성물의 공개 범위.
저작권과 라이선스
생성 이미지의 권리와 PixAI 모델의 상업적 이용 조건.
기계 판독용 버전
- /llms.txt는 이 문서의 모든 페이지를 한 줄 요약과 함께 나열하고, /llms-full.txt는 모든 페이지를 하나의 Markdown 파일로 담고 있습니다.
- 페이지 URL 끝에
.mdx를 붙이면 해당 페이지를 Markdown으로 받을 수 있습니다. 예: /ko/docs/quick-start/limits.mdx
도움이 필요하신가요?
api@withpixai.art로 메일을 보내시거나 PixAI 공식 Discord의 #api-beta-test 채널을 이용해 주세요. 자세한 내용은 피드백을 참고하세요.