빠른 시작
첫 번째 API 호출
PixAI API를 처음 사용하는 방법을 단계별로 안내합니다.
기본 URL: https://api.pixai.art/v2
인증: 모든 요청에 Authorization: Bearer YOUR_API_KEY 헤더를 추가하세요. API 키 발급 방법은 PixAI API를 사용하려면?을 참고하세요.
단계
작업 제출
POST /image/create를 전송합니다. 필수 필드는 modelVersionId와 prompt입니다.
curl -X POST https://api.pixai.art/v2/image/create \
-H "Authorization: Bearer $PIXAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"modelVersionId": "1983308862240288769",
"prompt": "1girl, green hair, masterpiece, best quality, solo, standing, flower",
"aspectRatio": "9:16",
"mode": "standard"
}'응답:
{
"id": "TASK_ID",
"status": "waiting",
"createdAt": "2026-03-04T04:32:10.635Z",
"updatedAt": "2026-03-04T04:32:10.635Z",
"outputs": {
"mediaIds": [],
"mediaUrls": []
}
}응답의 id를 기록해 두세요 — 다음 단계에서 사용하는 TASK_ID입니다.
modelVersionId는 PixAI의 모델 버전 URL https://pixai.art/model/<id>/<modelVersionId>에서 마지막 세그먼트입니다. 추천 모델은 모델을 참고하세요.
상태 폴링
status가 완료 상태가 될 때까지 반복합니다.
curl https://api.pixai.art/v1/task/TASK_ID \
-H "Authorization: Bearer $PIXAI_API_KEY"| 상태 | 의미 |
|---|---|
waiting | 작업이 대기 중 |
running | 생성 진행 중 |
completed | 완료, 결과물 준비됨 |
failed | 생성 실패 |
cancelled | 작업이 취소됨 |
completed 상태가 되면 outputs.mediaUrls에 이미지 URL이 포함됩니다.
폴링은 1.5초에 한 번을 초과하지 마세요. 재시도 시 지수 백오프를 사용하세요. 각 계정은 waiting 또는 running 상태의 작업을 동시에 최대 10개까지 허용합니다. 자세한 내용은 제한 사항을 참고하세요.
이미지 다운로드
curl -L "MEDIA_URL" -o output.png
# 또는 미디어 ID로:
curl -L https://api.pixai.art/v1/media/MEDIA_ID/image \
-H "Authorization: Bearer $PIXAI_API_KEY" -o output.png생성된 이미지는 영구적으로 보관되지 않습니다 — 작업이 완료되는 즉시 다운로드하세요.