Alibaba · 이미지

Hermes Agent 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가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

Hermes Agent + Z Image로 만들 수 있는 것

  • 영화와 애니메이션 스토리보드

    스토리보드 프레임을 빠르게 생성해, 창작 회의가 진행되는 동안 구도와 카메라 앵글을 반복해서 다듬습니다.

  • 전자상거래 제품 시각화

    대량 카탈로그 작업을 위해 소재와 조명이 사실적인 상품 페이지 이미지를 생성합니다.

  • 교육용 일러스트

    교과서, 강의 자료, 교육 콘텐츠에 쓸 이중 언어 라벨이 달린 도표와 일러스트를 만듭니다.

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

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

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

  • 명확한 사용 요금

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

  • 자동화된 작업 워크플로

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

Hermes Agent + Z Image 자주 묻는 질문

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

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

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

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

RunAPI를 통한 Z Image에서 사용자 지정 LoRA를 쓸 수 있나요?

아니요. RunAPI 엔드포인트는 사용자 지정 어댑터가 없는 기본 모델을 제공합니다. 파인튜닝한 결과가 필요하다면 공개 가중치와 자체 LoRA를 로컬에서 실행하세요.

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

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

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

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

Hermes Agent에서 Z Image 사용 시작하기

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

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

문의하기