WeShop Z-Image OpenAPI Skill for Openclaw

A professional-grade text-to-image generation skill powered by Alibaba's Z-Image engine and integrated via the WeShop OpenAPI.

sparkleming
v1.0.1
Apr 10, 2026
0
361
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install z-image-openapi-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install z-image-openapi-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is WeShop Z-Image OpenAPI Skill?

The WeShop Z-Image OpenAPI Skill enables AI agents to create high-fidelity visual content directly from text descriptions. By leveraging the advanced Z-Image model from Alibaba, this skill provides a robust bridge between conceptual prompts and professional-quality imagery. It is designed to function as a core component within the ecosystem of Openclaw Skills, allowing for seamless image generation workflows.

This skill prioritizes security and efficiency, utilizing a direct connection to the official WeShop OpenAPI. It handles the complexities of asynchronous image generation, including task submission and status polling, ensuring that developers can focus on the creative output rather than infrastructure management.

WeShop Z-Image OpenAPI Skill Use Cases

  • Creating high-quality marketing assets and social media visuals from text prompts.
  • Generating multiple variations of an image concept using batch processing.
  • Automating visual content creation for e-commerce and digital storefronts.
  • Integrating professional AI image generation into custom developer workflows using Openclaw Skills.

How WeShop Z-Image OpenAPI Skill Works

  1. The user provides a text description and optional parameters like aspect ratio to the skill.
  2. The skill initiates a run by sending a POST request to the WeShop OpenAPI agent endpoint.
  3. The API returns an execution ID, and the skill enters a polling phase to monitor the job status.
  4. Once the status reaches Success, the skill retrieves the final image URLs from the execution results.
  5. The generated images are delivered back to the primary AI agent or user interface.

WeShop Z-Image OpenAPI Skill Setup

To get started with this skill, you must obtain an API key from the WeShop developer portal and configure your environment.

# Export your WeShop API Key to your environment
export WESHOP_API_KEY="your_api_key_here"

Ensure that your Openclaw Skills configuration has HTTPS access to openapi.weshop.ai. The API key should be used directly in the Authorization header without the Bearer prefix.

WeShop Z-Image OpenAPI Skill Data Schema & Taxonomy

The skill interacts with the WeShop API using structured JSON payloads. Below is the primary schema for run parameters:

Field Type Default Description
textDescription string Required Detailed description of the image to generate
aspectRatio string 1:1 Output ratio (e.g., 16:9, 4:3, 9:16, 21:9)
batchCount integer 1 Number of images to generate (range: 1-16)

Success responses provide a data.executions array containing the final image URLs and metadata.

WeShop Z-Image OpenAPI Skill Advanced Features

  • Multi-ratio support: Choose from various aspect ratios including 21:9 for cinematic or 9:16 for mobile content.
  • Batch Generation: Generate up to 16 images in a single request to rapidly iterate on visual concepts.
  • Asynchronous Polling: Robust status tracking from Pending through Success or Failed states.
  • Local Asset Integration: Ability to upload local images via the assets endpoint to obtain reusable URLs for complex AI workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*