소개
Z-Image 텍스트→이미지는 글로 쓴 묘사를 이미지 한 장으로 만듭니다. 보통 1초 정도 걸립니다. 핵심은 이 속도입니다. 생성이 싸지기 때문에 한 번에 결정할 일이 아니라 반복해서 돌리는 과정으로 다룰 수 있습니다.
Z-Image는 Tongyi의 소형 6B 이미지 모델 계열로, 약 1초 만에 실사 결과를 내도록 조정되었으며 여기서는 텍스트→이미지 엔드포인트 하나로 공개됩니다. 화면비 5종, 무손실 PNG, 1,000자 프롬프트를 지원합니다. 무검열입니다.
핵심 기능 및 하이라이트
신중한 프롬프트 하나보다 스무 번의 반복
장당 1초 정도라면 프롬프트를 방어적으로 쓸 필요가 없습니다. 한 줄 쓰고, 보고, 고치고, 다시 봅니다. 반복이 짧아서 감이 추측이 아니라 결과에서 쌓이며, 여기서 스무 번 시도해도 무거운 마무리용 모델을 한 번 호출하는 것보다 쌉니다.
스튜디오의 광택이 아니라 스냅 사진의 질감
가장 강한 영역은 화려하지 않은 쪽입니다. 휴대폰으로 찍은 거울 셀카, 천장의 형광등, 약간의 흔들림, 젖은 머리. 스냅을 요청하면 렌더링이 아니라 찍은 것처럼 보이는 이미지가 돌아옵니다. 더 무거운 모델이 광을 내다 지워 버리는 바로 그 부분입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 1,000자로, 일부러 작게 잡은 예산입니다. 이 엔드포인트는 문장을 실험으로 다룰 수 있을 만큼 빨리 돌아오므로, 통째로 다시 쓰지 말고 한 번에 하나씩만 바꿔 보세요. 1자 이상 · 1000자 이하 |
aspect_ratio | 아니요 | 출력 모양입니다. 다섯 가지가 있고 기본은 정사각, 16:9 가로부터 9:16 세로까지입니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐이라 프롬프트가 쓴 그대로 사용됩니다. 켜면 더 나은 결과를 위해 생성 전에 모델이 짧은 프롬프트를 더 자세한 묘사로 다시 씁니다. 기본값: |
output_format | 아니요 | 값은 |
seed | 아니요 | 무작위 출발점을 정하는 0에서 2147483647까지의 정수입니다. 빼면 실행마다 각자 값을 뽑습니다. |
요금
$0.01 / 장
활용 사례
글로 쓴 브리프에서 시작하기
글로 쓴 아이디어를 빠르게 여러 버전으로 보고 싶을 때 이 엔드포인트를 씁니다. 호출할 때마다 약 1초 만에 화면비 5종 중 하나로 무손실 PNG 한 장이 돌아옵니다. 통한 프롬프트는 seed와 함께 모두 보관하십시오.
캐릭터를 대량으로 탐색하기
캐릭터 인물 사진과 롤플레이 장면 설정을 한 번에 스무 방향씩 탐색합니다. 표시할 플래그도, 별도 엔드포인트도 없습니다. 실행마다 다른 이미지가 나오므로 통한 프롬프트를 남기고 의상과 배경을 한 부분씩 바꾸십시오.
마무리용 모델 전의 콘셉트 작업
장당 1초 정도인 여기서 구도를 찾고, 통한 문구를 상한이 높은 느린 모델로 가져가 납품용 버전을 만드십시오. 사진 어휘가 같으므로 다시 짤 필요가 없습니다.
진짜 스냅처럼 보이는 콘텐츠
거울 셀카, 체육관의 형광등, 맨 천장 조명, 휴대폰 카메라 같은 자연스러운 구도. 피드에서 실제 사진처럼 읽히는 결입니다. 결점은 분명히 요청하십시오: 형광등 색 캐스트, 모션 블러, 고르지 않은 초점.
프롬프트 가이드 및 실전 팁
브리프는 짧고 구체적으로
1,000자는 작은 예산입니다. 빛, 렌즈, 질감에 쓰십시오. 공개된 스틸 이미지는 다음 프롬프트에서 나왔습니다. ‘iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.’
남길 이미지에는 프롬프트를 함께 두기
seed가 없으면 같은 요청이라도 매번 다른 이미지가 나옵니다. 프롬프트와 seed를 파일 옆에 저장하고, 더 나은 것을 찾는 동안에는 한 부분씩만 바꾸십시오. seed를 고정해 두면 보이는 차이는 그 부분에서 나온 것입니다.
포함된 예시 고쳐 쓰기
공개된 예시에서 시작하고 aspect_ratio는 1:1, output_format은 png로 둡니다. 피사체와 연출은 바꾸되 이 모드의 입력 규칙은 그대로 유지합니다.
iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.
공개된 스틸 이미지 뒤의 요청을 정사각형으로 바꾼 것입니다. 품질을 요구하는 대신 광원, 흔들림, 프레이밍을 구체적으로 적은 스냅 브리프입니다.
반복하기 전에 결과 확인하기
프롬프트 상한은 1,000자이며, 더 긴 프롬프트는 잘리는 것이 아니라 요청을 보내기 전에 거부됩니다. 이 모델은 샷 목록보다 짧고 탄탄한 브리프에서 좋은 결과를 냅니다. 화면비마다 모델 고유의 약 100만 화소 안팎의 고정 크기가 정해져 있어 해상도 전환도, 큰 납품용 이미지로 가는 방법도 없습니다. 섬세한 타이포그래피와 빽빽한 작은 디테일은 6B 모델이 잘하는 일이 아닙니다.
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": "alibaba/z-image-turbo/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png",
"enable_prompt_expansion": false
}
}'
# 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 레퍼런스에서 확인하세요.
