ClawHub

z-image

API key required
Other

Generate and edit images with Z-Image through RunAPI. Use when the user asks an agent to create, edit, or transform images with Z-Image. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.

Install

openclaw skills install runapi-z-image

Z-Image on RunAPI

Generate and edit images with Z-Image through RunAPI. The default path for one-off agent tasks is the runapi CLI; SDKs are for application integration.

Routing decision

  • One-off generation, editing, or transformation for the user → use the CLI path with the runapi binary.
  • Building an app, backend, worker, library, or production codebase → use the SDK integration path.

CLI path

The runapi binary is the runtime dependency. Authenticate with runapi login (browser) or set RUNAPI_API_KEY; a saved CLI config also works — no required environment variable.

Inspect the available actions and request fields with CLI help:

runapi z-image --help
runapi z-image text-to-image --help

Run a one-off task (synchronous — polls until the task completes):

runapi z-image text-to-image --input-file request.json

Submit asynchronously and poll separately:

runapi z-image text-to-image --async --input-file request.json
runapi wait <task-id> --service z-image --action text-to-image

Available actions: text-to-image.

SDK integration path

When integrating Z-Image into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:

  • JavaScript / TypeScript: @runapi.ai/z-image
  • Ruby: runapi-z_image
  • Go: github.com/runapi-ai/z-image-sdk/go

References