---
title: "PixAI API 문서"
description: "PixAI API 개발자 문서. REST API, API 키 인증, 비동기 작업, Webhook으로 애니메이션 스타일 AI 이미지를 프로그램에서 생성할 수 있습니다. 빠른 시작으로 시작한 뒤 v2 / v1 엔드포인트 참조로 이동하세요."
canonical: "https://platform.pixai.art/ko/docs"
last-updated: "2026-11-02"
---

# PixAI API 문서

PixAI API 개발자 문서. REST API, API 키 인증, 비동기 작업, Webhook으로 애니메이션 스타일 AI 이미지를 프로그램에서 생성할 수 있습니다. 빠른 시작으로 시작한 뒤 v2 / v1 엔드포인트 참조로 이동하세요.





PixAI API를 사용하면 [pixai.art](https://pixai.art/ko)와 동일한 모델(Tsubaki.2, Haruka v2, Hoshino v2 등)로 애니메이션 스타일의 AI 아트를 애플리케이션에서 생성할 수 있습니다. `https://api.pixai.art`에서 제공되는 REST API로, API 키로 인증하고 생성 작업을 제출한 뒤 작업이 완료되면 이미지를 가져오는 방식입니다.

API 동작 방식 [#api-동작-방식]

1. **API 키 받기.** PixAI API 팀에 신청하거나 PixAI 프로필에서 키를 만든 뒤, 모든 요청에 `Authorization: Bearer <key>` 헤더를 보냅니다. 자세한 내용은 [PixAI API 사용 방법](/ko/docs/quick-start/enroll-in-api)을 참고하세요.
2. **작업 만들기.** 프롬프트, 모델, 화면 비율이나 스타일 같은 선택 설정을 `POST /v2/image/create`로 보내면 `waiting` 상태의 작업이 반환됩니다.
3. **완료 기다리기.** `GET /v1/task/{taskId}`를 1.5초에 한 번 이하로 폴링하거나, [Webhook](/ko/docs/references/webhook)을 등록해 완료 시 작업 객체를 받습니다.
4. **이미지 다운로드.** 완료된 작업에는 미디어 URL이 포함됩니다. `GET /v1/media/{mediaId}`는 미디어 정보를, `GET /v1/media/{mediaId}/image`는 파일로 리디렉션을 반환합니다. 생성물은 무기한 보관되지 않으므로 필요한 파일은 저장해 두세요.

문서 둘러보기 [#문서-둘러보기]

<Cards>
  <Card title="빠른 시작" description="API 액세스 받기, 첫 요청 보내기, 현재 제한 사항." href="/ko/docs/quick-start/enroll-in-api" />

  <Card title="이미지 생성 (API v2)" description="화면 비율, 모드, 스타일 프리셋을 포함한 POST /v2/image/create 참조." href="/ko/docs/api-v2/image/createImage" />

  <Card title="작업과 미디어 (API v1)" description="작업 상태 조회, 미디어 조회 및 업로드." href="/ko/docs/api/task/getTask" />

  <Card title="모델" description="사용 가능한 이미지 모델의 ID, 버전, 샘플링 방법." href="/ko/docs/references/models" />

  <Card title="지원 해상도" description="화면 비율과 해상도 등급별 출력 크기." href="/ko/docs/references/supported-resolutions" />

  <Card title="Webhook" description="폴링 대신 POST로 작업 상태 업데이트 받기." href="/ko/docs/references/webhook" />

  <Card title="제한 사항" description="동시 실행 한도, 폴링 권장 간격, API에서 아직 지원하지 않는 기능." href="/ko/docs/quick-start/limits" />

  <Card title="FAQ" description="이메일과 멤버십으로 키를 받는 방식의 차이, 점검 안내, API 생성물의 공개 범위." href="/ko/docs/faq" />

  <Card title="저작권과 라이선스" description="생성 이미지의 권리와 PixAI 모델의 상업적 이용 조건." href="/ko/docs/about/copyright" />
</Cards>

기계 판독용 버전 [#기계-판독용-버전]

* [/llms.txt](/llms.txt)는 이 문서의 모든 페이지를 한 줄 요약과 함께 나열하고, [/llms-full.txt](/llms-full.txt)는 모든 페이지를 하나의 Markdown 파일로 담고 있습니다.
* 페이지 URL 끝에 `.mdx`를 붙이면 해당 페이지를 Markdown으로 받을 수 있습니다. 예: [/ko/docs/quick-start/limits.mdx](/ko/docs/quick-start/limits.mdx)
* [/openapi.json](/openapi.json)은 API v2의 OpenAPI 3.1 명세입니다([YAML](/openapi-spec.v2.yaml)). [/.well-known/api-catalog](/.well-known/api-catalog)에는 API 버전별 명세 위치가 있습니다.

도움이 필요하신가요? [#도움이-필요하신가요]

[api@withpixai.art](mailto:api@withpixai.art)로 메일을 보내시거나 [PixAI 공식 Discord](https://discord.com/invite/pixai&#x29;의 **#api-beta-test** 채널을 이용해 주세요. 자세한 내용은 [피드백](/ko/docs/about/feedback)을 참고하세요.