이미지 생성 작업 생성

간소화된 v2 API를 사용하여 새 이미지 생성을 시작합니다. v2 API는 `aspectRatio`(종횡비), `mode`(품질 모드), 명명된 `style` 프리셋 등 사용자 친화적인 파라미터를 제공하며, v1의 원시 픽셀 치수 및 내부 파라미터명을 대체합니다.

Authorization

bearerAuth

AuthorizationBearer <token>

인증이 필요한 모든 요청에는 HTTP 헤더에 다음을 추가하세요

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

modelVersionId*string

생성에 사용할 모델 버전의 고유 식별자입니다. 더 이상 사용되지 않는 modelId 필드의 권장 대체 필드입니다.

modelVersionId를 찾는 방법:

PixAI 모델 페이지를 엽니다.
사용하려는 모델 버전을 클릭합니다.
URL의 마지막 경로 세그먼트를 복사합니다 — 이것이 modelVersionId입니다.

예시 URL: https://pixai.art/model/<id>-<slug>/<modelVersionId> → modelVersionId는 <modelVersionId>.

Length1 <= length

prompt*string

생성하고 싶은 콘텐츠를 설명하는 메인 프롬프트입니다.

Length1 <= length

negativePrompt?string

생성 이미지에 포함되지 않기를 원하는 요소를 설명하는 텍스트입니다.

aspectRatio?string

생성 이미지의 종횡비입니다. 기본값은 1:1입니다.

사용 가능한 비율: 1:1, 2:3, 3:2, 3:4, 4:3, 3:5, 5:3, 9:16, 16:9, 1:3, 3:1

모든 비율은 모든 모델 유형(SDXL, DiT, Tsubaki.2)에서 사용 가능합니다.

크기 등급별 전체 해상도 매핑은 지원 해상도를 참조하세요.

Default"1:1"

Value in"1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "3:5" | "5:3" | "9:16" | "16:9" | "1:3" | "3:1"

size?string

출력 해상도 등급입니다. 1.5k의 최장변은 1536 px입니다.

1k: 약 1메가픽셀 (예: 1:1에서 1024×1024).
1.5k: 약 2.36메가픽셀 (예: 1:1에서 1536×1536).

전체 매핑 테이블은 지원 해상도를 참조하세요.

Default"1k"

Value in"1k" | "1.5k"

mode?stringTsubaki.2 전용

생성 품질과 속도를 제어하는 추론 프로파일입니다.

lite: 가장 빠름, 기본 품질.
standard: 속도와 품질의 균형(기본값).
pro: 높은 품질, 느림.
ultra: 최고 품질, 가장 느림.

Default"standard"

Value in"lite" | "standard" | "pro" | "ultra"

style?|Tsubaki.2 전용

생성 중 적용할 스타일입니다. 명명된 프리셋이나 커스텀 스타일 문자열을 지정할 수 있습니다.

loras?array<>

출력 스타일이나 콘텐츠를 미세 조정하기 위한 LoRA 어댑터입니다. 최대 5개까지 조합할 수 있습니다.

LoRA modelId를 찾는 방법:

PixAI LoRA 모델 페이지를 엽니다.
사용하려는 LoRA 버전을 클릭합니다.
URL의 마지막 경로 세그먼트를 복사합니다 — 이것이 LoRA 버전 ID입니다.

예시 URL: https://pixai.art/model/<loraModelId>/<loraVersionId> → LoRA 버전 ID는 <loraVersionId>.

Itemsitems <= 5

seed?integer

재현 가능한 생성을 위한 랜덤 시드입니다. 생략하면 무작위로 생성됩니다.

sampling?SDXL / SD v1 전용

확산 프로세스를 미세 조정하기 위한 고급 샘플링 파라미터입니다. 모든 필드는 선택 사항이며, 생략 시 모델의 기본값이 사용됩니다.

모델별 지원 샘플링 메서드는 모델 목록 페이지를 참조하세요.

promptHelper?string

생성 전 프롬프트를 자동으로 강화하는 내장 프롬프트 도우미 사용 여부입니다.

enable: 프롬프트를 자동으로 강화합니다(기본값).
disable: 프롬프트를 그대로 사용합니다.

Default"enable"

Value in"enable" | "disable"

callbackUrl?string

작업 상태 변경 시 POST 요청을 받을 공개 URL(웹훅)입니다.

작업 상태가 변경될 때 이 URL로 POST 요청이 전송됩니다.

Formaturi

Response Body

`application/json`

curl -X POST "https://api.pixai.art/v2/image/create" \  -H "Content-Type: application/json" \  -d '{    "modelVersionId": "1983308862240288769",    "prompt": "1girl, green hair, solo, standing",    "aspectRatio": "9:16",    "mode": "standard"  }'

{
  "id": "string",
  "status": "waiting",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "startedAt": "2019-08-24T14:15:22Z",
  "endAt": "2019-08-24T14:15:22Z",
  "outputs": {
    "mediaIds": [
      "string"
    ],
    "mediaUrls": [
      "string"
    ]
  }
}

Empty

이미지 생성 작업 생성

Authorization

Request Body

Response Body

201application/json

401

500

`application/json`