Alibaba · Image

Hermes Agent x Z Image

Z Image is Alibaba's speed-optimized text-to-image model, generating results very fast. Through RunAPI, it shares the same API shape and billing as all Alibaba models.

1 variants from $0.01 / call Commercial OK

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use z-image when it matches the task: 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: Generate a clean product shot of white sneakers on a gradient background, studio lighting.
/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 and save the returned Task id.
GET /api/v1/z_image/text_to_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
z-image
/api/v1/z_image/text_to_image
$0.01 / call Model detail

Verify

Poll until the task reaches a terminal status

POST /api/v1/z_image/text_to_image and save the returned Task id.
GET /api/v1/z_image/text_to_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Configuration

Guide endpoint: /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"
}'
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with Hermes Agent + Z Image

  • Storyboarding for film and animation

    Generate storyboard frames quickly, iterating on compositions and camera angles while a creative discussion is still happening.

  • E-commerce product visualization

    Produce product listing images with realistic materials and lighting for high-volume catalog work.

  • Educational illustrations

    Create diagrams and illustrations with bilingual text labels for textbooks, course materials, and training content.

Why Use Z Image Through RunAPI + Hermes Agent

  • 1 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

Hermes Agent + Z Image Questions

Can I use Z Image in Hermes Agent?

Yes. If RunAPI is configured as a provider in Hermes Agent, the same API key handles Z Image requests. Call the endpoint shown on this page.

When should I choose Z Image over other image models?

Z Image is suited to high-volume work and concept exploration where speed and cost matter most. For final selects that need maximum fidelity, compare it with a higher-end image model.

Does Z Image support custom LoRA adapters through RunAPI?

No. The RunAPI endpoint serves the base model without custom adapters. If you need fine-tuned output, run the open weights locally with your own LoRA.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using Z Image with Hermes Agent

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us