Alibaba · Image

OpenClaw 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 OpenClaw + Z Image

  • Concept exploration and rapid prototyping

    Generate many visual concepts quickly and cheaply to explore directions before committing to a higher-fidelity model for final output.

  • Bilingual marketing campaigns

    Create marketing visuals with Chinese and English text rendered in the same image, useful for cross-border e-commerce and multilingual social media.

  • Fashion and product photography mockups

    Generate realistic product mockups with believable materials and lighting, fast enough to iterate on compositions.

Why Use Z Image Through RunAPI + OpenClaw

  • 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.

OpenClaw + Z Image Questions

Can I use Z Image in OpenClaw?

Yes. If RunAPI is configured as a provider in OpenClaw, 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.

Can Z Image render Chinese and English text in the same image?

Yes. You can mix both languages in the prompt, and the model handles typography for both scripts, which helps with multilingual labels and marketing materials.

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 OpenClaw

Building with a team?

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

Contact Us