한 줄 답변: 엔드포인트를 작업별로, 그리고 살아 있는 카탈로그가 각 엔드포인트에 붙이는 콘텐츠 라벨로 좁히고, 그다음에는 각자 여러분의 브리프를 몇 번씩 실행해 완료된 작업 수가 아니라 쓸 수 있는 결과 수를 세세요. "순화됨"이라고 라벨된 엔드포인트는 톤이 낮아진 이미지로 성공이자 과금된 작업을 돌려주므로, 초록색 상태는 아무것도 증명하지 않습니다. 또한 SpicyAPI는 요청도 결과도 검사하지 않으므로, 여러분 제품이 법과 자체 규칙 안에 머무르게 하는 확인 작업은 여러분이 직접 만들어야 합니다. 아래의 라벨과 가격은 2026년 10월 초 기준이며, 기준이 되는 것은 살아 있는 무검열 이미지 생성 API 카탈로그입니다.
콘텐츠 라벨이 통합에 무슨 의미가 있는가
카탈로그의 각 이미지 엔드포인트에는 네 가지 라벨 중 하나가 붙습니다. 카탈로그에서 운영 중인 59개 이미지 엔드포인트 중 40개는 무검열, 3개는 순화, 12개는 필터, 4개는 라벨 없음(배경 제거, 업스케일링 등 유틸리티)입니다.
| 라벨 | 모델 한계를 넘는 브리프에 API가 무엇을 하는가 | 여러분이 직접 처리할 것 |
|---|---|---|
| 무검열 | 모델이 콘텐츠 필터를 선언하지 않으며 SpicyAPI는 스캔을 추가하지 않고 요청을 전달합니다. | 호출 전후의 자체 확인. |
| 순화됨 | 작업은 성공하고 과금되지만 이미지가 톤을 낮춘 상태로 돌아옵니다. | 출력을 확인하세요. 상태 코드는 알려주지 않습니다. |
| 필터 | 모델이 거부합니다. 작업은 failed와 errorCode: "content_rejected"로 끝납니다. | 중립적인 메시지를 보여주고 그대로 재시도하지 마세요. 거부는 보통 과금되지 않지만 일부 모델 페이지는 과금된다고 적어 두었으니 그 페이지를 읽으세요. |
| 라벨 없음 | 측정하지 않음. | 어느 쪽으로도 가정하지 마세요. |
라벨은 패밀리가 아니라 엔드포인트에 속합니다. Wan 2.7 Pro의 텍스트에서 이미지는 순화로 표시되지만 편집 엔드포인트는 무검열입니다. 둘을 섞은 벤치마크는 서로 다른 두 약속을 비교하는 셈입니다. 라벨은 또한 정보 제공용일 뿐입니다. 무엇을 기대해야 할지는 알려 주지만 무엇이 보장되는지는 알려 주지 않습니다.
플랫폼 측 스캔이 없기 때문에 콘텐츠 및 이용 정책의 무조건 규칙은 여러분 제품의 몫이 됩니다. 미성년자가 관련된 성적 표현, 기록된 동의 없이 식별 가능한 실존 인물의 친밀한 묘사(얼굴 교체 포함), 타인 사칭은 모두 금지입니다. 호출 앞에 나이 확인, 실존 인물 입력에 대한 동의 기록, 사용자가 콘텐츠를 신고할 수 있는 경로를 두세요. 더 자세한 내용은 "Building on a less restrictive model"에 있습니다(지금은 영어만).
작업으로 좁히고 그다음 라벨과 가격으로
첫 워크플로에 대해 문장 하나를 쓰세요. 예를 들면 "라이선스 받은 패션 이미지를 배경만 바꿔 편집한다"입니다. 그 문장이 필요한 작업을 알려 줍니다. 작업은 각각 별도의 카탈로그 항목이고 필드도 별개입니다. 가격은 각 페이지의 가장 낮은 "부터" 가격이며, 해상도와 참조 이미지, 옵션에 따라 최종 금액이 달라집니다.
| 엔드포인트 | 작업 | 라벨 | 부터 | 페이지가 밝힌 용도 |
|---|---|---|---|---|
| Qwen Image 3.0 | 텍스트에서 이미지, 편집 | 무검열 | $0.03 | 한 장에서 세 장까지의 참조 이미지 편집. 이미 화면 안에 있는 글자 다시 쓰기 포함 |
| Seedream 5.0 Pro | 텍스트에서 이미지, 편집 | 무검열 | $0.036 | 최대 열 장의 참조 이미지로 한 화면 구성, 각 장에 이름 붙은 역할 부여 |
| Z-Image Spicy | 텍스트에서 이미지 | 무검열 | $0.0124 | 정확한 픽셀 크기로 텍스트에서 이미지, 프롬프트 확장은 직접 켜지 않으면 꺼짐 |
| Prefect Pony XL | 텍스트에서 이미지 | 무검열 | $0.015 | 태그 방식 프롬프트에서 만든 애니메이션과 삽화 스틸 |
| Wan 2.7 Pro | 텍스트에서 이미지, 편집 | 순화됨(텍스트에서 이미지) | $0.075 | 대형 캔버스 이미지 한 장, 기본 2k, 최대 4k. 필터링은 엔드포인트마다 다름 |
| Krea 2 Medium | 텍스트에서 이미지 | 순화됨 | $0.03 | 긴 프롬프트에서 흔한 다섯 비율 중 하나로 이미지 한 장, 기본 PNG. 빗나간 결과를 다시 조정할 seed가 없음 |
| Nano Banana 2 | 텍스트에서 이미지, 편집 | 필터 | $0.036 | 최대 열네 장의 참조 이미지를 사용한 편집, 0.5K에서 4K까지 |
이 목록은 순위가 아니라 후보 목록입니다. 성인 대상 제품이라면 작업에 맞는 무검열 행에서 시작하세요. 순화된 행은 브리프가 그 한계 안쪽에 충분히 머무를 때만 쓸 만합니다. 필터 행은 혼합 제품에서 전체 이용가(SFW)인 쪽에 맞습니다. Prefect Pony XL은 쉼표로 구분한 태그와 고정된 일곱 크기를 기대하므로, 포토리얼 모델용으로 문장으로 쓴 브리프 대신 태그 방식 프롬프트를 넣으세요.
각 모델 페이지는 테스트 보고서를 연결합니다. 예를 들어 Z-Image Spicy와 Seedream 5.0 Pro입니다. 실제 출력이 암시적인 장면부터 강한 성인 장면까지 담고 있고 중앙값 시간(Z-Image Spicy 약 18 s, Seedream 5.0 Pro 약 70 s)이 있습니다. 먼저 그것들을 읽고, 그다음 여러분 서버에서 작업 생성부터 내려받을 수 있는 결과까지의 대기 시간을 측정하세요.
예의바른 대체물이 아니라 여러분의 브리프를 쓰세요
여러분의 제품이 실제로 제공할 강도로 브리프를 쓰세요. 가상의 성인 캐릭터나 사용 허가를 받은 입력으로 하면 됩니다. 전체 이용가(SFW) 대체 브리프 묶음은 순화된 엔드포인트를 통과할 수 있습니다. 순화는 브리프가 모델 한계를 넘었을 때만 나타나기 때문입니다. 브리프는 티켓이나 공개 문서가 아니라 비공개 테스트 저장소에 두세요. 각 픽스처를 세 번 실행하세요. 불안정성을 드러내기에 충분하고, 변경 뒤에 반복하기에 충분히 저렴합니다.
| ID | 픽스처 | 알려 주는 것 |
|---|---|---|
| 01 | 가장 자주 쓰는 브리프를 평소 강도로 | 기준이 되는 유용 결과 비율 |
| 02 | 같은 브리프를 허용할 최대 강도로 | 엔드포인트가 허용 범위 상단에서 거절하는지, 순화하는지, 전달하는지 |
| 03 | 픽스처 01의 무해한 세 가지 바꿔쓰기 | 표현을 바꾸면 결과가 뒤집히는가 |
| 04 | 승인된 원본 이미지에 이름 붙은 편집 하나(배경, 옷 색, 조명) | 편집이 먹히고 보호된 부분이 살아남는가 |
| 05 | 같은 편집에 참조 이미지 두 장을 더하고 각각 이름 붙은 역할 부여 | 추가 참조가 도움이 되는지, 결과를 흐리게 하는지, 그리고 가격에 무엇을 더하는지 |
| 06 | 실제로 게시할 화면 비율(예: 9:16) | 실제 크기에서 구도가 유지되는가 |
| 07 | 여러분 앱이 막아야 하는 브리프 | 사전 확인이 막고 작업이 만들어지지 않는다는 것 |
| 08 | 전송 직후 잘린 요청 | 클라이언트가 기존 작업을 찾아 두 번 지불하지 않는다는 것 |
실행 전에 서면 통과 규칙을 정하세요. 주제와 구도가 브리프와 일치할 것. 편집의 보호 영역이 그대로일 것. 강도가 요청보다 더 누그러지지 않을 것. 고객이 눈치챌 만한 신체 구조나 글자 결함이 없을 것. 후보마다 숫자 두 개를 기록하세요. 유용 결과 비율(규칙을 통과한 출력을 완료된 작업으로 나눈 값)과 유용 결과 하나당 비용(총 지출을 같은 수로 나눈 값)입니다. 이 값이 있어야 값싸지만 순화된 엔드포인트를 더 비싸지만 신뢰할 수 있는 엔드포인트와 비교할 수 있습니다. 더 완전한 채점 기준은 이미지 API 벤치마크 가이드를 쓰세요.
먼저 Playground에서 픽스처 하나를 해보세요
- 후보 목록에 있는 엔드포인트 페이지를 엽니다. 예를 들어 Z-Image Spicy 텍스트에서 이미지 페이지에서 충전된 계정으로 로그인합니다. 폼은 페이지에 있습니다.
- 픽스처 01을 Prompt에 붙이고 화면 크기를 정합니다(여기서는 Width와 Height. 다른 엔드포인트는 화면 비율 또는 크기 항목을 씁니다).
- 폼 아래 가격을 읽고 Run을 누른 다음, 분포를 보기 위해 두 번 더 반복 실행합니다.
- 픽스처 02와 03도 같은 방식으로 실행하고, 코드를 한 줄도 쓰기 전에 각각의 결과를 통과 규칙으로 판단하세요.
필름 프레임이 프로젝터를 통과해 완성된 이미지 한 장이 된다.
그다음 같은 테스트를 스크립트로 돌리기
픽스처가 Playground에서 기대한 대로 동작하면 파일에서 실행하세요. 견적은 무료입니다. 보낼 본문을 그대로 검증하고, 아무것도 만들지 않으며, 자금도 묶어 두지 않습니다.
spicyapi tasks quote --model alibaba/z-image-spicy/text-to-image --input-file fixture-01.json같은 파일에서 tasks create로 작업을 만드세요. 재시도와 폴링, 결과는 작업 문서와 CLI 문서에 있습니다.
또는 에이전트에게 맡겨도 됩니다. MCP 서버를 쓰면 어시스턴트가 spicyapi_task_quote로 견적을 받고, npx skills add spicyapi-ai/spicy-skill는 호출마다 살아 있는 스키마를 먼저 읽게 하는 Agent Skill을 설치합니다.
테스트 하네스를 만드는 방식을 바꾸는 사실 다섯 가지입니다.
- 견적은 가장 싼 테스트입니다. 첫 유료 실행 전에 모든 픽스처를 견적에 통과시키고, 라벨은 바뀔 수 있으니 CI에서 각 엔드포인트의 라벨을 다시 확인하세요.
- 각 엔드포인트는 자기 항목 이름만 받고, 모르는 항목은 거부합니다. 출력 크기만으로도 표기가 세 가지입니다. Z-Image는
aspect_ratio, Prefect Pony XL은 단일size, Z-Image Spicy는width와height를 씁니다. 하나의 공유 요청이 아니라 살아 있는 스키마에서 엔드포인트별 어댑터를 만드세요. - 참조 이미지가 가격을 올릴 수 있습니다. 두 번째부터 각 장마다 Seedream 5.0 Pro 견적에 더해지므로, 실제 참조 이미지 수로 본문을 그대로 견적받으세요.
succeeded는 쓸 수 있다는 뜻이 아닙니다. 모델이 무언가를 돌려줬다는 뜻뿐입니다. 순화된 이미지는 통과 규칙에서 잡아내세요. 거부는 보통 과금되지 않습니다.- 시간 초과된 create가 이미 존재할 수 있습니다. 두 번 지불하지 말고 같은 Idempotency-Key로 다시 보내세요. 그것이 픽스처 08입니다.
다운로드 링크와 생성 파일은 만료되므로, 승인한 이미지는 작업 참조를 곁에 두어 여러분의 저장소로 복사하세요(미디어 보관 글). 폴링과 웹훅 비교는 "Polling versus webhooks" 가이드를 보세요(지금은 영어만).
선택하는 방법
첫 워크플로에 필요한 작업을 공개하지 않는 엔드포인트는 제외하세요. 픽스처 07과 08에서 떨어지는 것도 제외하세요. 나머지는 같은 브리프로 유용 결과 비율과 유용 결과 하나당 비용을 비교하세요. 허용하는 강도 범위에서 비율이 가장 좋은 무검열 엔드포인트를 선호하세요. 순화되거나 필터된 엔드포인트는 한계가 브리프에 맞을 때에만 남기고, "무엇이든 가능하다"고 약속하는 대신 여러분 제품 문구에 그대로 쓰세요. 폴백도 같은 픽스처를 통과해야 합니다.
자주 묻는 질문
무검열 엔드포인트가 API에 자동으로 더 나은 선택인가요.
아닙니다. 필터가 없다고 선언되었다는 뜻이지, 여러분 브리프를 따르거나 쓸 수 있는 이미지당 비용이 더 싸다는 뜻이 아닙니다.
순화된 엔드포인트가 이미지를 톤 낮춘 것인지 어떻게 아나요.
픽스처 02를 픽스처 01과 비교하세요. 순화된 엔드포인트는 주제는 남지만 요청한 강도를 잃습니다. 작업 응답에는 그것을 알려 주는 항목이 없습니다.
거부에 비용이 있나요.
보통은 없습니다. 실패한 작업은 보류금을 전부 해제합니다. 일부 모델 페이지는 특정 거부가 과금된다고 적어 두었으니, 무료라고 단정하기 전에 작업 비용을 확인하세요.
실제 고객 사진으로 테스트할 수 있나요.
처음에는 할 수 없습니다. 승인된 입력이나 합성 입력을 쓰세요. 실존 인물이 포함된 입력에는 해당 편집과 배포에 대한 기록된 동의가 필요하며, 미성년자가 관련된 것은 언제나 허용되지 않습니다.
작업이 끝났으면 이미지를 사용자에게 보여줄 수 있다는 뜻인가요.
아닙니다. 작업이 끝났다는 것은 모델이 무언가를 돌려줬다는 뜻뿐입니다. 통과 규칙으로 확인하세요. 순화된 결과도 그곳에서 잡힙니다. 전달하기 전에 승인한 이미지를 여러분 저장소로 복사하세요.
확인을 얼마나 자주 다시 해야 하나요.
출시 전과, 모델·라벨·가격·스키마가 바뀔 때마다 다시 실행하세요.
