---
title: "기능"
description: "PixAI API로 할 수 있는 것: 애니메이션 모델과 LoRA로 이미지 생성, 참조 이미지, 인페인팅과 아웃페인팅, 이미지에서 동영상, 참조 동영상, 그리고 작업·크레딧·제한의 작동 방식."
canonical: "https://platform.pixai.art/ko/docs/features"
last-updated: "2026-11-17"
---

# 기능

PixAI API로 할 수 있는 것: 애니메이션 모델과 LoRA로 이미지 생성, 참조 이미지, 인페인팅과 아웃페인팅, 이미지에서 동영상, 참조 동영상, 그리고 작업·크레딧·제한의 작동 방식.



PixAI API는 [pixai.art](https://pixai.art/ko)와 같은 애니메이션 모델과 커뮤니티 LoRA로 작동합니다. pixai.art 사용자가 생성하는 것을 여러분의 애플리케이션에서도 생성할 수 있습니다. 이 페이지에서는 API로 할 수 있는 것, 작동 방식, 아직 지원하지 않는 기능을 각 기능의 레퍼런스 링크와 함께 소개합니다.

생성할 수 있는 것 [#capabilities]

| 기능              | 엔드포인트                                                                             | 설명                                                                     |
| --------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| 텍스트에서 이미지       | [`POST /v2/image/create`](/ko/docs/api-v2/image/createImage)                      | PixAI 모델로 프롬프트에서 이미지를 1장 또는 4장 생성합니다. LoRA, 스타일 프리셋, 색상 팔레트도 쓸 수 있습니다. |
| 참조 이미지          | [`POST /v2/image/create`](/ko/docs/api-v2/image/createImage)의 `contextImages`     | 최대 3장의 이미지를 참조합니다. 캐릭터를 일관되게 유지하거나 다른 이미지에서 포즈를 가져올 수 있습니다.            |
| 인페인팅·아웃페인팅·리드로우 | [`POST /v2/gen-task/inpaint`](/ko/docs/api-v2/image/createInpaint)                | 마스크한 영역을 다시 그리거나, 이미지를 바깥으로 확장하거나, 이미지 전체를 다시 그립니다.                    |
| 이미지에서 동영상       | [`POST /v2/frame-video/create`](/ko/docs/api-v2/video/createFrameVideo)           | Tsubaki 동영상 모델로 이미지를 5\~15초 동영상으로 만듭니다. 두 번째 이미지로 끝내거나 사운드를 넣을 수 있습니다. |
| 참조 동영상          | [`POST /v2/reference-video/create`](/ko/docs/api-v2/video/createReferenceVideo)   | 참조 이미지를 바탕으로 동영상을 생성합니다. 모델에 따라 참조 동영상과 오디오도 쓸 수 있습니다.                 |
| 모델과 LoRA        | [`GET /v2/generation-model/search`](/ko/docs/api-v2/model/searchGenerationModels) | [PixAI 모델 마켓](https://pixai.art/ko/model)에서 생성에 쓸 베이스 모델과 LoRA를 검색합니다. |

이미지 [#images]

* **모델:** Tsubaki.3, Tsubaki.2, Haruka v2, Hoshino v2 같은 PixAI 자체 모델과 모델 마켓의 다른 베이스 모델을 쓸 수 있습니다. [모델](/ko/docs/references/models)을 참고하세요.
* **크기:** `1:3`부터 `3:1`까지 11가지 화면 비율과 두 가지 해상도(`1k`, `1.5k`) 중에서 고릅니다. Tsubaki.3의 큰 출력 같은 다른 크기는 모델의 크기 범위 안에서 `width`와 `height`를 지정합니다. [지원 해상도](/ko/docs/references/supported-resolutions)를 참고하세요.
* **품질과 속도:** `mode`로 추론 프로필(`lite`, `standard`, `pro`, `ultra`)을 고릅니다. 모델이나 플랜에 따라 쓸 수 없는 모드가 있습니다.
* **LoRA:** 멤버십 없이 최대 3개, 멤버십이 있으면 최대 15개의 LoRA를 각각의 가중치로 적용할 수 있습니다. LoRA는 생성 모델과 같은 베이스 모델용이어야 합니다.
* **프롬프트:** Tsubaki.2와 Tsubaki.3에서는 최대 10,000자(다른 모델은 4,096자)의 프롬프트, 네거티브 프롬프트, 같은 결과를 재현하는 `seed`, 짧은 프롬프트를 보완하는 프롬프트 도우미를 쓸 수 있습니다.
* **스타일과 색상:** 이름이 붙은 `style` 프리셋과 Tsubaki.3의 색상 팔레트를 쓸 수 있습니다.

이미지 편집 [#editing]

* **인페인팅:** 마스크의 흰색 영역을 다시 그립니다.
* **아웃페인팅:** 이미지를 더 큰 캔버스에 놓고 늘어난 영역을 채웁니다.
* **리드로우:** 마스크 없이 이미지 전체를 다시 그립니다. `strength`로 원본에서 얼마나 달라져도 되는지 정합니다.

마스크 형식은 [인페인팅과 아웃페인팅 예제](/ko/docs/quick-start/examples/inpainting-and-outpainting)를 참고하세요.

동영상 [#video]

| 엔드포인트     | 모델                              | 참조                          | 길이     |
| --------- | ------------------------------- | --------------------------- | ------ |
| 이미지에서 동영상 | Tsubaki(`tbkv1.0.1`, `tbkv1.0`) | 첫 프레임, 선택적으로 마지막 프레임        | 5\~15초 |
| 참조 동영상    | Tsubaki                         | 이미지 1\~6장, 오디오 최대 3개        | 5\~15초 |
| 참조 동영상    | Seedance 2, Seedance 2 Fast     | 이미지 9장, 동영상 3개, 오디오 3개까지    | 4\~15초 |
| 참조 동영상    | Seedance 2.5                    | 이미지 30장, 동영상 10개, 오디오 10개까지 | 4\~30초 |
| 참조 동영상    | Vidu                            | 이미지 1\~7장                   | 3\~16초 |

두 동영상 엔드포인트 모두 사운드를 생성할 수 있으며, 대사는 영어·일본어·한국어·중국어 중에서 고르거나 대사 없이 만들 수 있습니다. `professional` 모드는 지원하는 모델에서 업스케일을 더합니다. 이미지에서 동영상을 만들려면 PixAI 멤버십이 필요합니다.

작동 방식 [#how-it-works]

* **HTTPS REST API**입니다. `https://api.pixai.art`에 API 키를 `Authorization: Bearer <key>`로 보내 인증합니다. [PixAI API를 사용하려면?](/ko/docs/quick-start/enroll-in-api)을 참고하세요.
* **비동기 작업:** 모든 생성 엔드포인트는 작업을 반환합니다. `completed`, `failed`, `cancelled` 중 하나가 될 때까지 [`GET /v2/task/{id}`](/ko/docs/api-v2/task/getTask)를 폴링하거나, [Webhook](/ko/docs/references/webhook)으로 상태 업데이트를 받습니다.
* **미디어 ID:** 입력과 출력은 미디어 ID로 다룹니다. 이미지와 오디오는 업로드 엔드포인트로 올리거나, 생성한 이미지를 다시 씁니다. [`GET /v2/media/batch`](/ko/docs/api-v2/media/batchGetMedia)로 미디어 ID를 다운로드 URL로 바꿉니다.
* **결과는 내려받아 보관:** 생성된 미디어는 계속 보관되지 않습니다. 작업이 끝나면 필요한 파일을 빨리 저장하세요.
* **비공개:** API로 생성한 결과는 pixai.art의 공개 생성 기록에 나타나지 않습니다.
* **기계가 읽을 수 있는 문서:** [OpenAPI 명세](/openapi.json), [llms.txt](/llms.txt), 모든 페이지의 Markdown 버전, 코딩 에이전트용 [문서 MCP 서버](/ko/docs/docs-mcp)가 있습니다.

처음부터 끝까지 해 보려면 [첫 번째 API 호출](/ko/docs/quick-start/first-api-call)을 따라 하세요.

크레딧 차감 방식 [#credits]

API는 API 키를 소유한 PixAI 계정의 크레딧을 사용합니다.

* **시점:** 크레딧은 작업을 생성할 때 차감됩니다. 실패한 작업의 크레딧은 환불됩니다.
* **금액:** 요청 내용에 따라 달라집니다.
  * 이미지: 모델, 출력 크기, `mode`, 생성 장수.
  * 인페인팅·아웃페인팅·리드로우: 이미지 크기와 `strength`.
  * 동영상: 모델, 길이, `professional` 모드, 사운드 생성 여부.
* **확인 방법:** 각 작업의 `paidQuota` 필드에 그 작업에 차감된 크레딧이 표시됩니다. 대량으로 실행하기 전에 요청을 한 번 보내 비용을 확인하세요.

이미지에서 동영상, 4개 이상의 LoRA, 일부 크기와 모드처럼 PixAI 멤버십이 필요한 기능이 있습니다. 플랜에 포함되지 않은 기능을 요청하면 오류로 거부됩니다.

제한 [#limits]

* 계정당 대기열에서 기다릴 수 있는 작업은 동시에 10개까지입니다. 실행 중인 작업은 포함되지 않으며, 상한은 계정별로 올릴 수 있습니다.
* 작업은 1.5초에 한 번 이하로 폴링하고, 재시도할 때는 간격을 늘리세요.

자세한 내용은 [제한 사항](/ko/docs/quick-start/limits)을 참고하세요.

API에서 아직 지원하지 않는 기능 [#not-available]

PixAI Reference Pro, PixAI Edit, PixAI Edit Lite는 pixai.art에서 쓸 수 있지만 API에서는 아직 지원하지 않습니다. 이 기능들은 현재 개발 중입니다.

권리와 상업적 이용 [#commercial-use]

API로 생성한 이미지의 저작권은 사용자에게 있으며, PixAI는 권리를 주장하지 않습니다. 승인된 사용자는 Tsubaki, Haruka 같은 PixAI 공식 모델을 상업적으로 이용할 수 있지만, 모델 파일 자체를 재판매하거나 재배포할 수는 없습니다. 생성한 콘텐츠가 제3자의 권리를 침해하지 않도록 해야 합니다. [저작권 및 관련 권리](/ko/docs/about/copyright)를 참고하세요.

다음 단계 [#next-steps]

* [빠른 시작](/ko/docs/quick-start): API 키를 발급받고 첫 요청을 보냅니다.
* [예제](/ko/docs/quick-start#steps): 이미지에서 동영상, 캐릭터 일관성, 인페인팅, LoRA의 완전한 스크립트.
* [API v2 레퍼런스](/ko/docs/api-v2/image/createImage): 모든 엔드포인트의 모든 파라미터.
