소개
P-H3-Image 텍스트→이미지는 장면 설명을 정지 이미지 1장으로 구현합니다. Pruna AI는 MiniMax H3를 이미지 생성과 편집에 맞게 개조하고 2026년 11월 3일 오픈웨이트를 공개했습니다.
핵심 기능 및 하이라이트
15가지 화면비와 별개로 1k, 1.5k, 2k, 3k, 4k를 선택합니다. 저희 테스트에서 4k와 16:9를 지정했을 때 5472 x 3072픽셀 이미지가 생성됐습니다. 결과 형식은 JPEG, PNG, WebP 중에서 선택합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 장면 설명이며 기본 텍스트는 없습니다. 형용사를 길게 나열하기보다 의상, 배경, 빛을 간결하게 묘사하십시오. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 15가지 화면비 중에서 선택합니다: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9. 생략하면 1:1로 생성하며 화면비 선택은 단계별 요금에 영향을 주지 않습니다. |
resolution | 아니요 | 1k(기본값, 약 1 MP), 1.5k(약 2.4 MP), 2k(약 4 MP), 3k(약 9.4 MP), 4k(약 16.8 MP) 중에서 선택합니다. 이 필드가 과금할 크기 단계를 결정합니다. |
output_format | 아니요 | 파일 인코딩의 기본값은 jpeg이며 png와 webp도 지원합니다. 인코딩 선택에 따른 추가 요금은 없습니다. |
seed | 아니요 | 선택 사항인 난수 소스 설정으로, 반드시 지정해야 하는 고정값은 없습니다. 같은 값을 유지하며 설정 하나를 바꾸면 공정하게 비교할 수 있지만 출력이 같다는 보장은 없습니다. |
요금
생성 이미지마다 선택한 크기 단계인 1k, 1.5k, 2k, 3k, 4k에 따라 과금합니다. 화면비와 형식에는 추가 요금이 없습니다. 편집 모드에서는 첫 번째 이후의 원본마다 소액이 추가됩니다. 상위 서비스의 요청 오류에는 과금하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.024 / 장 |
| $0.036 / 장 |
| $0.048 / 장 |
| $0.096 / 장 |
| $0.144 / 장 |
활용 사례
장면 설명으로 에디토리얼 인물 사진, 다이너의 영화 스틸, 짧은 네온 간판 문구를 만듭니다. 기존 사진을 바꾸려면 이미지 편집을 선택하십시오.
프롬프트 가이드 및 실전 팁
피사체, 의상, 장소, 광원을 구체적으로 적으십시오. Pruna AI에 따르면 따옴표로 묶은 짧은 단어는 표현할 수 있지만 긴 문구나 작은 글씨는 잘못된 문자로 나타날 수 있습니다. seed를 유지하고 요소 하나만 바꾸며 결과를 비교하십시오. seed가 출력을 고정하지는 않습니다. 저희 테스트에서는 높은 해상도 단계일수록 시간이 더 걸렸으며, 4k 생성 1건의 모델 처리 시간은 241초였습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pruna-ai/p-h3-image/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.




