기능

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

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

생성할 수 있는 것

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

이미지

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

이미지 편집

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

마스크 형식은 인페인팅과 아웃페인팅 예제를 참고하세요.

동영상

엔드포인트모델참조길이
이미지에서 동영상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 멤버십이 필요합니다.

작동 방식

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

처음부터 끝까지 해 보려면 첫 번째 API 호출을 따라 하세요.

크레딧 차감 방식

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

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

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

제한

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

자세한 내용은 제한 사항을 참고하세요.

API에서 아직 지원하지 않는 기능

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

권리와 상업적 이용

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

다음 단계

  • 빠른 시작: API 키를 발급받고 첫 요청을 보냅니다.
  • 예제: 이미지에서 동영상, 캐릭터 일관성, 인페인팅, LoRA의 완전한 스크립트.
  • API v2 레퍼런스: 모든 엔드포인트의 모든 파라미터.