Alibaba · 이미지

OpenClaw x Z Image

Z Image는 매우 빠르게 결과물을 생성하는 Alibaba의 속도 최적화 텍스트-이미지 모델입니다. RunAPI를 통해 모든 Alibaba 모델과 동일한 API 형태 및 과금 방식을 공유합니다.

1 variants 최저 $0.01 / 회 상업적 사용 지원

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 z-image를 사용하세요: z-image.

You have access to RunAPI task tools for Z Image.

Available Z Image models:
- z-image: z-image
  endpoints: /api/v1/z_image/text_to_image
  request fields: model, prompt, aspect_ratio

Use the model ID and endpoint that match the user's request.
Example prompt: 그라디언트 배경 위에 흰색 운동화의 깔끔한 제품 사진을 스튜디오 조명으로 생성해 주세요.
/api/v1/z_image/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/z_image/text_to_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/z_image/text_to_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
z-image
/api/v1/z_image/text_to_image
$0.01 / 회 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

POST /api/v1/z_image/text_to_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/z_image/text_to_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

설정

가이드 엔드포인트: /api/v1/z_image/text_to_image

export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/z_image/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image",
  "prompt": "A cobalt vase on white marble.",
  "aspect_ratio": "1:1"
}'
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

OpenClaw + Z Image로 만들 수 있는 것

  • 콘셉트 탐색과 빠른 프로토타이핑

    많은 시각 콘셉트를 빠르고 저렴하게 생성해 방향을 정한 뒤, 최종 결과물에는 충실도가 더 높은 모델을 사용합니다.

  • 중영 이중 언어 마케팅 캠페인

    한 이미지에 중국어와 영어 텍스트를 함께 담은 마케팅 이미지를 만들어 해외 직판 전자상거래와 다국어 소셜 미디어에 활용합니다.

  • 패션과 제품 사진 목업

    소재와 조명이 자연스러운 사실적인 제품 목업을 구도 반복 작업이 가능한 속도로 생성합니다.

Z Image을(를) RunAPI + OpenClaw로 사용하는 이유

  • 1개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

OpenClaw + Z Image 자주 묻는 질문

OpenClaw에서 Z Image를 사용할 수 있나요?

네. RunAPI가 OpenClaw의 공급자로 설정되어 있다면 같은 API 키로 Z Image 요청을 처리할 수 있습니다. 이 페이지에 표시된 엔드포인트를 호출하세요.

다른 이미지 모델 대신 Z Image를 선택해야 하는 경우는 언제인가요?

Z Image는 속도와 비용이 가장 중요한 대량 작업과 콘셉트 탐색에 적합합니다. 최고 수준의 충실도가 필요한 최종 이미지는 더 상위의 이미지 모델과 비교해 보세요.

Z Image는 한 이미지에 중국어와 영어 텍스트를 함께 표현할 수 있나요?

네. 프롬프트에 두 언어를 섞어 쓸 수 있고, 모델이 두 문자 체계의 타이포그래피를 모두 처리해 다국어 라벨과 마케팅 자료에 도움이 됩니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

OpenClaw에서 Z Image 사용 시작하기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기