Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 이미지가 없습니다. 폼을 제출해 이미지를 생성하세요.
다양한 사용 사례와 매개변수 구성을 살펴보세요
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
z-image-turbo imageqwen | Starter | 0.15per run | $0.001 | - | - |
z-image 사용 전체 가이드
ApiPass를 통해 z-image/turbo를 통합하여 자연어 프롬프트로부터 낮은 지연 시간의 비동기 작업을 통해 사실적인 이미지를 생성하세요. 이 모델은 속도, 처리량, 사실적인 출력, 안정적인 텍스트 렌더링, 합리적인 이미지 생성 비용이 필요한 프로덕션 워크로드를 위해 설계되었습니다.
Z-Image-Turbo는 Tongyi-MAI의 60억 파라미터 텍스트-이미지 모델로, 프로덕션에 적합한 시각 품질과 빠른 이미지 생성을 위해 설계되었습니다. 효율적인 저단계 생성 설계를 사용하여 강력한 사실성, 구도, 이미지 내 텍스트 표현 능력을 유지하면서 전체 이미지를 빠르게 생성합니다. ApiPass를 통해 z-image/turbo는 텍스트-이미지 생성 및 선택적인 단일 참조 이미지 기반 생성용 비동기 REST API로 제공됩니다. 각 작업은 하나의 이미지를 생성하며, 완료된 결과는 resultJson.resultUrls에 이미지 URL로 반환됩니다.
자연어 프롬프트로 고품질의 사실적인 이미지를 생성하세요. Z Image Turbo는 시네마틱 장면, 제품 비주얼, 히어로 배너, UI 이미지, 썸네일, 소셜 콘텐츠, 빠른 크리에이티브 반복 작업에 적합합니다.
공개적으로 접근 가능한 참조 이미지 URL 하나를 제공하고, 프롬프트로 원하는 변환을 설명하세요. strength 파라미터를 통해 출력이 프롬프트를 따르는 정도와 참조 이미지를 보존하는 정도를 제어할 수 있습니다.
POST /api/v1/jobs/createTask로 생성 작업을 제출하고 반환된 taskId를 저장한 다음, 3~5초마다 GET /api/v1/jobs/recordInfo를 폴링하거나 완료 콜백을 위해 callBackUrl을 제공하세요. 성공 시 resultJson.resultUrls[0]에서 생성된 이미지를 확인합니다.
Z Image Turbo는 사실적인 조명, 질감, 분위기, 구도를 유지하면서 낮은 지연 시간의 이미지 생성을 위해 최적화되어 있습니다. 인터랙티브 제품, 디자인 도구, 대시보드, 대규모 콘텐츠 백엔드에 적합합니다.
이 모델은 영어와 중국어 프롬프트를 이해하며 생성된 이미지 안에 다국어 텍스트를 직접 렌더링할 수 있어 포스터, 캠페인 비주얼, UI 목업, 소셜 그래픽, 여러 시장을 대상으로 하는 크리에이티브 워크플로에 유용합니다.
size 파라미터를 1024*1024와 같은 WIDTH*HEIGHT 픽셀 문자열로 사용하세요. ApiPass는 픽셀 치수를 문자열로 전달하므로 정사각형 또는 직사각형 출력 크기를 지정할 수 있으며, 반각 별표 형식이 필요합니다.
무작위 결과를 얻으려면 seed를 -1로 설정하거나, 유사한 출력을 재현하는 데 도움이 되도록 고정 정수를 사용하세요. 이는 통제된 실험, 브랜드 검토, 프롬프트 반복, 일관된 크리에이티브 변형 생성에 유용합니다.
사용자가 빠른 클릭-이미지 워크플로를 기대하는 크리에이티브 앱, 챗봇, 디자인 어시스턴트, 내부 도구를 위한 빠른 프롬프트-이미지 경험을 구축하세요.
프로덕션 워크플로를 늦추지 않고 제품 사진, 캠페인 콘셉트, 히어로 배너, 썸네일, 소셜 미디어 이미지, 카탈로그 비주얼을 대규모로 생성하세요.
단일 참조 이미지와 변환 프롬프트를 사용하여 스타일화된 변형, 장면 변경, 비주얼 리프레시 또는 통제된 재해석을 만들고, strength를 미묘한 수준부터 극적인 수준까지 조정하세요.
이미지 안에 보이는 텍스트를 포함하는 포스터, 만화 스타일 패널, 프로모션 그래픽, UI 목업을 만들고, 프롬프트 수준에서 스타일, 분위기, 레이아웃을 제어하세요.
ApiPass의 프로덕션 애플리케이션에서 z-image/turbo를 안정적으로 통합하려면 다음 구현 참고 사항을 활용하세요.
Create Task API가 code 200과 함께 HTTP 200을 반환한다는 것은 작업이 접수되었다는 의미일 뿐입니다. 이미지가 완료되었다는 뜻은 아닙니다. data.taskId를 저장하고 폴링 또는 콜백을 계속 진행하세요.
/api/v1/jobs/recordInfo를 3~5초마다 폴링하세요. waiting, queuing, generating 상태에서는 폴링을 계속합니다. success 또는 fail이 되면 즉시 중지하세요. 성공 시 resultJson.resultUrls를 읽고, 실패 시 failCode와 failMsg를 확인하세요.
문서화된 입력 필드인 prompt, image, size, strength, seed, output_format만 전송하세요. size 값은 1024*1024와 같은 WIDTH*HEIGHT 픽셀 문자열이어야 하며, 1024x1024 또는 종횡비 라벨을 사용하면 안 됩니다.
소스 모델 카드에는 생성된 이미지당 $0.005부터의 가격이 표시되어 있습니다. 실제 요금은 ApiPass 라우팅, 계정 설정, 채널 선택, 현재 과금 규칙에 따라 달라질 수 있으므로 요청에 표시되는 실시간 ApiPass 가격을 확인하세요.
ApiPass는 auto, starter, regular, official을 포함한 채널 옵션을 지원합니다. 기본 auto 채널은 사용 가능한 제공업체, 가격, 안정성 지표를 기반으로 작업을 라우팅합니다.
Z Image Turbo는 효율적인 생성을 위해 설계되어 카탈로그 이미지, 피드 자산, 자동 생성 썸네일, 반복적인 크리에이티브 테스트와 같은 대규모 배치에 실용적입니다.
텍스트 프롬프트로 시작하고, 1024*1024와 같은 크기를 선택하며, 무작위 결과를 위해 seed를 -1로 유지하고, 출력 형식으로 jpeg, png 또는 webp를 선택하세요. 가이드 생성이 필요할 때만 참조 이미지 URL을 추가하세요.
model을 z-image/turbo로 설정하고 모든 모델 파라미터를 input 안에 넣어 POST https://api.apipass.dev/api/v1/jobs/createTask를 호출하세요. 상태 확인을 위해 반환된 data.taskId를 저장합니다.
3~5초마다 GET /api/v1/jobs/recordInfo?taskId=<TASK_ID>를 조회하거나, 작업 생성 시 callBackUrl을 제공하세요. 작업이 success 또는 fail에 도달하면 중지합니다.
data.state가 success이면 resultJson.resultUrls[0]에서 생성된 이미지를 확인하세요. 각 z-image/turbo 작업은 일반적으로 생성된 이미지 URL 하나를 반환합니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
텍스트-이미지 생성 또는 단일 참조 이미지 기반 생성을 위한 새로운 z-image/turbo 비동기 이미지 생성 작업을 제출합니다.
API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "z-image/turbo",
3 "callBackUrl": "https://example.com/webhooks/apipass",
4 "channel": "auto",
5 "input": {
6 "prompt": "string",
7 "image": "string (optional)",
8 "size": "1024*1024",
9 "strength": 0.6,
10 "seed": -1,
11 "output_format": "jpeg"
12 },
13 "fallback_models": null
14}model필수string공개 모델 식별자입니다. 대소문자와 철자를 포함하여 정확히 z-image/turbo여야 합니다.
"z-image/turbo"
input필수object이미지 생성 파라미터입니다. 모든 모델별 필드는 이 input 객체 안에 배치해야 합니다.
{"prompt":"A cinematic Shanghai street corner cafe after rain"}callBackUrl선택적string or null작업이 성공하거나 실패한 후 POST 콜백을 수신하는 공개적으로 접근 가능한 HTTP 또는 HTTPS URL입니다. 생략하거나 null인 경우 콜백이 전송되지 않습니다. 필드 이름은 반드시 callBackUrl로 정확히 작성해야 합니다.
"https://example.com/webhooks/apipass"
channel선택적string라우팅 및 과금 채널입니다. 기본 채널은 auto입니다. APIPASS는 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 간에 작업을 자동 할당합니다. starter는 할당량이 제한되고 안정성이 낮은 초저가 옵션입니다. regular는 표준 옵션이며 공식 API보다 훨씬 저렴하고 안정성은 보통 수준입니다. official은 모델 네이티브 API를 사용하며 높은 안정성, 빠른 작업 실행, 공식 가격을 제공합니다.
기본 채널은 auto입니다. APIPASS는 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 간에 작업을 자동 할당합니다. starter는 할당량이 제한되고 안정성이 낮은 초저가 옵션입니다. regular는 표준 옵션이며 공식 API보다 훨씬 저렴하고 안정성은 보통 수준입니다. official은 모델 네이티브 API를 사용하며 높은 안정성, 빠른 작업 실행, 공식 가격을 제공합니다.
사용 가능한 옵션:
auto
fallback_models선택적array<object> or null고급 모델 폴백 구성입니다. 각 항목은 model, channel 및 대상 모델의 전체 input을 포함하는 객체여야 합니다. 폴백 input은 기본 input과 자동으로 병합되지 않습니다. 일반적인 z-image/turbo 호출에서는 이 필드를 생략하세요.
null
input 객체에는 다음 파라미터가 포함됩니다:
input.prompt필수string생성할 이미지에 대한 텍스트 설명입니다. 참조 이미지 기반 생성의 경우 참조 이미지를 어떻게 변환할지 설명합니다.
필수입니다. 검증 전에 앞뒤 공백을 제거하세요. prompt에는 공백이 아닌 문자가 하나 이상 포함되어야 합니다. image가 제공된 경우 prompt를 사용해 원하는 수정 내용 또는 목표 결과를 설명하세요.
"A cinematic Shanghai street corner cafe after rain, warm neon lights, realistic photography"
input.image선택적string단일 참조 이미지 URL입니다. 텍스트-이미지 생성에는 이 필드를 생략하고, 참조 이미지 기반 생성에는 제공하세요.
서버가 직접 가져올 수 있는 공개적으로 접근 가능한 HTTP 또는 HTTPS 이미지 URL이어야 합니다. 로컬 브라우저 경로, 쿠키 또는 로그인 상태가 필요한 URL, 또는 임시 리디렉션 후에만 작동하는 URL을 전달하지 마세요. 이 필드는 배열이 아니라 하나의 URL 문자열을 받습니다. 일반적인 JPEG, PNG, WebP 이미지 URL을 권장합니다.
"https://example.com/reference.png"
input.size선택적string출력 픽셀 크기 문자열입니다. 기본값은 1024*1024입니다. ApiPass는 이를 문자열로 수신하고 픽셀 치수로 전달합니다.
10241024와 같이 반각 별표를 사용하는 WIDTHHEIGHT 형식을 사용하세요. 1024x1024 또는 종횡비 문자열을 사용하지 마세요. 현재 공개 스키마는 완전한 고정 enum을 정의하지 않으므로 제출 전에 형식을 검증하세요.
"1024*1024"
input.strength선택적number참조 이미지 변환 강도입니다. 유효 범위는 0 이상 1 이하입니다. 값이 높을수록 일반적으로 원본 참조 이미지와 더 다른 결과가 생성됩니다. 기본값: 0.6.
input.image가 제공된 경우에만 의미가 있습니다. 0부터 1까지의 슬라이더를 사용하고 권장 step은 0.01입니다. 0은 참조 이미지에 가장 가깝게 유지하고, 0.3은 가벼운 수정, 0.6은 균형, 0.8은 prompt를 더 강하게 따르며, 1은 가장 큰 변화를 생성합니다. 이러한 레이블은 UI 안내용이며 엄격한 수학적 보장은 아닙니다.
0.6
input.seed선택적integer생성 seed입니다. 모든 정수를 사용할 수 있으며 -1은 무작위 seed를 의미합니다. 기본값: -1.
무작위 seed에는 -1을 사용하세요. 동일한 파라미터와 고정 seed는 유사한 결과를 재현하는 데 도움이 될 수 있지만, 픽셀 수준에서 동일한 출력이 보장되지는 않습니다.
42
input.output_format선택적string출력 이미지 형식입니다. 기본값: jpeg.
나열된 값만 사용하세요. jpg, tiff 또는 기타 지원되지 않는 형식을 전달하지 마세요.
사용 가능한 옵션:
"jpeg"
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "z-image/turbo",
6 "callBackUrl": "https://example.com/webhooks/apipass",
7 "channel": "auto",
8 "input": {
9 "prompt": "A cinematic Shanghai street corner cafe after rain, warm neon lights, realistic photography, rich details",
10 "image": "https://example.com/reference.png",
11 "size": "1024*1024",
12 "strength": 0.6,
13 "seed": 42,
14 "output_format": "png"
15 }
16 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_555ad751dff448f8"
6 }
7}code비즈니스 상태 코드입니다. 200은 작업이 성공적으로 수락되었음을 의미합니다.
message응답 메시지입니다. 작업 생성 요청이 성공한 경우 일반적으로 success입니다.
data.taskIdApiPass 작업 ID입니다. 이 값을 저장하고 작업 상태와 결과를 조회하는 데 사용하세요.
flux
flux
Generate photorealistic images with robust text
시작가
0 크레딧
Nano Banana 2 Lite, aka Gemini 3.1 Flash-Lite Image, is a newly released image model from Google DeepMind built for fast 1K image generation, efficient creative iteration, prompt-based image editing, and responsive visual output in product-facing creative scenarios.
시작가
0 크레딧
OpenAI
OpenAI
Generate intentionally designed visuals with less prompting using the latest OpenAI GPT Image 2 model.
시작가
0 크레딧
Nano Banana now allows you to freely draw on edited images, bringing you a completely new experience. Simply click on the image to draw whatever you want. You can also add text and details, and Gemini will do the rest.
시작가
0 크레딧
Fast image generation model built on Gemini 3.1 Flash Image. Supports text-to-image, image editing, multi-image fusion with up to 14 reference images, Google Search grounding, and outputs up to 4K resolution.
시작가
0 크레딧
seedream
seedream
시작가
0 크레딧
grok
grok
Grok Imagine is xAI’s AI video generation model for creating high-quality videos with realistic motion, native audio, and synchronized speech. Grok Imagine 1.5 introduces faster generation speeds, improved motion physics, and stronger visual consistency for modern AI video applications.
시작가
0 크레딧
seedream
seedream
시작가
0 크레딧
OpenAI
OpenAI
Bring your ideas to life with sharper, faster, more precise image generation using the GPT Image 2.5 API.
시작가
0 크레딧
wan
wan
Generate images with cinematic precision through high-fidelity text-to-image synthesis and structural editing.
시작가
0 크레딧
seedream
seedream
Gemini said Generate images with lightning-fast efficiency and high-fidelity detail through a streamlined, lightweight architecture optimized for instant creative expression.
시작가
0 크레딧
qwen
qwen
Generate realistic 2K images with structured text
시작가
0 크레딧
Luma
Luma
시작가
0 크레딧
seedream
seedream
시작가
0 크레딧