z-imagelisted

# 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. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth. Inspect the available commands and request fields with CLI help: ```shell runapi z-image --help runapi z-image text-to-image --help ``` Run a one-off task (synchronous — polls until the task completes): ```shell runapi z-image text-to-image --input-file request.json ``` Submit asynchronously and poll separately: ```shell runapi z-image text-to-image --async --input-file request.json runapi wait <task-id> --service z-image --action text-to-image ``` Available commands: `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