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.

Public versions and endpoints

Model ID	Version	Endpoints	Starting price	Catalog
`z-image`	z-image	`/api/v1/z_image/text_to_image`	$0.010	Model detail

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"
}'

Verify

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.

How it works

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.

FAQ

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.