Z Image API
초고속 텍스트-이미지 변환, 사실적인 결과물, 짧은 추론 경로를 위한 Z Image API 액세스.
curl -X POST https://runapi.ai/api/v1/z_image/text_to_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "그라디언트 배경 위에 흰색 운동화의 깔끔한 제품 사진을 스튜디오 조명으로 생성해 주세요."
}'
import { ZImageClient } from "@runapi.ai/z-image";
const client = new ZImageClient();
const result = await client.textToImage.run({
model: "z-image",
prompt: "그라디언트 배경 위에 흰색 운동화의 깔끔한 제품 사진을 스튜디오 조명으로 생성해 주세요.",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\ZImage\ZImageClient;
$client = new ZImageClient();
$result = $client->textToImage->run([
'model' => 'z-image',
'prompt' => '그라디언트 배경 위에 흰색 운동화의 깔끔한 제품 사진을 스튜디오 조명으로 생성해 주세요.',
]);
require "runapi/z_image"
client = RunApi::ZImage::Client.new
result = client.text_to_image.run(
model: "z-image",
prompt: "그라디언트 배경 위에 흰색 운동화의 깔끔한 제품 사진을 스튜디오 조명으로 생성해 주세요."
)
npx skills add runapi-ai/z-image -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Z Image는 8번의 추론 단계로 약 1초 만에 이미지를 생성하는 Alibaba의 초고속 텍스트-이미지 모델입니다. 일관성 있고 고품질 출력물을 유지하면서 생성 속도를 우선시합니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
요금
스펙
| 모델 ID | z-image |
| 제공사 | Alibaba |
| 모달리티 | image |
| 작업 유형 | asynchronous |
| 과금 | call |
| Endpoint | /api/v1/z_image/text_to_image |
| 상업적 사용 | 예 |
| 카탈로그 상태 | 운영 중 |
앱 개발을 위해 Z Image skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/z-image -g
Install the Z Image skill for this app: 1. Add runapi-ai/z-image with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
Z Image의 위치
Z Image는 매우 빠르게 결과물을 생성하는 Alibaba의 속도 최적화 텍스트-이미지 모델입니다. RunAPI를 통해 모든 Alibaba 모델과 동일한 API 형태 및 과금 방식을 공유합니다.
RunAPI로 Z Image을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
Z Image 생성 속도는 얼마나 빠른가요?
8번의 추론 단계로 약 1초 — 사용 가능한 텍스트-이미지 모델 중 가장 빠른 모델 중 하나입니다.
느린 모델과 품질이 비슷한가요?
Z Image는 프로덕션 사용에 적합한 사실적이고 일관된 이미지를 생성합니다. 복잡한 장면에서 최대 충실도가 필요하다면 Qwen 2나 Imagen 4를 고려하세요.
Z Image가 이렇게 빠른 이유는 무엇인가요?
Z Image는 8번의 추론 단계만으로 실행되는 증류 아키텍처를 사용하여, 시각적 일관성을 유지하면서 생성 시간을 극적으로 단축합니다.
Z Image의 출력 해상도는 어떻게 되나요?
웹 및 소셜 미디어에 적합한 표준 해상도입니다. 더 높은 해상도가 필요하면 Z Image와 Topaz 업스케일링을 함께 사용하세요.
Z Image는 대량 생성에 적합한가요?
네 — 빠른 속도는 e커머스 카탈로그, 소셜 미디어 에셋, 썸네일 생성과 같은 대용량 파이프라인에 이상적입니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.
Z Image와 비슷한 모델
Z Image로 개발을 시작하세요.
- text_to_image