Model:
Output aspect ratio. Custom WxH pixel sizes remain accepted in JSON mode when supported upstream.
USD estimate $0.004-$0.008: highest recharge package uses $1 = 2,000 credits; entry package uses $1 = 1,000 credits.
History
Saved locally in this browser
0 running · 0 completed
Billing Rules
Authentication
Every request needs a Bearer token in the Authorization header. Create an API key in the console.
Authorization: Bearer YOUR_API_KEYhttps://apiany.ai/v1/images/generationsRequest parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
model | string | Required | Model identifier to invoke. Use this model's ID. |
prompt | string | Required | Text prompt describing what you want to generate. |
size | string | Optional | Output aspect ratio. Custom WxH pixel sizes remain accepted in JSON mode when supported upstream. · Options: 1:1, 16:9, 9:16, 4:3, 3:4 · Default: 1:1 |
callback_url | string | Optional | Optional webhook URL called when the async task finishes. |
Request example
curl "https://apiany.ai/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "A clean product hero image for APIAny.AI, modern API gateway console, bright studio lighting",
"size": "1:1"
}'Response example
{
"task_id": "task_abc123",
"status": "pending",
"poll_url": "/v1/tasks/task_abc123",
"request_id": "req_abc123",
"credits": {
"reserved": 1000
}
}This endpoint is asynchronous: it returns a task_id immediately. Poll the task-status endpoint until status becomes succeeded, then read the result. Generated media links stay valid for 24 hours.
Model overview
Alibaba Z-Image is a lightweight text-to-image model for fast, cost-conscious generation across posters, product visuals, and high-volume content workflows.
Start with the desired visual outcome, references, and delivery format, then shape the generation workflow around them.
Z-Image is available on APIAny as one documented API surface with live pricing, model status, request examples, and an on-page playground. Teams can evaluate the model here, then keep authentication, usage records, and production routing in the same platform.
Try Z-Image in the playground
Sources
The quotations below are from official API documentation that APIAny implements against.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
The Gemini API provides access to Google's most capable generative AI models.
Use cases
The Z-Image API is used for product workflows that need this model's output. Test the same inputs in the playground, compare related models, and choose the route that meets your quality, latency, and budget requirements.
01
Use Z-Image to create visual directions for launches, ads, landing pages, and social campaigns. Standardize prompts and reference assets so a team can compare variants without rebuilding the generation workflow.
Try Z-Image in the playground
02
Generate product scenes, catalog assets, presentation imagery, or review-ready content with Z-Image. Batch requests through the API when a catalog needs consistent formats and repeatable output.
Try Z-Image in the playgroundCore capabilities
Z-Image API features are the input, output, and workflow traits that matter when you evaluate this model. Available request parameters remain visible in the live API reference on this page.
/01
Describe the requested output or task in text and send it through the documented Z-Image API request.
/02
Receive generated image results through the API response or asynchronous task result, depending on the selected Z-Image endpoint.
/03
Use the faster Z-Image route for interactive experiences, rapid iteration, and workloads where response time matters.
/04
Run higher-volume Z-Image workloads while using live pricing and request-level usage records to control spend.
/05
APIAny advantages
Z-Image on APIAny is a production route with one key, live prices, status, and usage records, so you do not maintain a separate provider integration.
Call Z-Image with an APIAny key and a documented request format. Keep your application integration stable while model versions and upstream routes evolve behind the gateway.
Review the live Z-Image pricing rules before a request, estimate credits in the playground, and inspect request-level usage records after the call completes.
Integration
Integrating the Z-Image API is a three-step path from playground test to authenticated production request. The page keeps the model identifier, request schema, pricing, and response examples together. Treat generation as an asynchronous media pipeline with durable task tracking, validation, and asset delivery.
Sign in to APIAny, create a project API key, and assign only the model scope and budget controls your application needs.
Copy the request example from this page, set the model field to the selected Z-Image version, and send it to the documented APIAny endpoint.
Track status, latency, credits, and returned usage. Compare versions or related models with the same workload before shifting production traffic.
FAQ
Direct answers about capabilities, use cases, integration, and choosing the right Z-Image route.
Alibaba Z-Image is a lightweight text-to-image model for fast, cost-conscious generation across posters, product visuals, and high-volume content workflows. APIAny makes this model callable through an authenticated API with live pricing, status information, request examples, and a browser playground on the same page.
Common Z-Image workflows include Campaign and marketing visuals, Product and catalog content, Rapid creative iteration. The best fit depends on the input format, output quality, latency, and cost your product requires.
Create an APIAny key, use the endpoint documented on this page, and set the request model field to the selected Z-Image version. The playground can generate a working payload before you integrate it into application code.
03
Turn a brief into multiple directions with Z-Image, then refine the strongest option through prompt changes or reference inputs. API-based iteration keeps experiments reproducible and easier to evaluate.
Try Z-Image in the playground
Choose a supported frame shape for square, portrait, landscape, or platform-specific Z-Image output.
Use model status, channel health, retry policy, and usage logs to operate Z-Image as part of a production workflow instead of treating it as an isolated demo.
Compare the versions shown on this page by price, supported parameters, and capabilities such as Text prompt input, Image generation output, Low-latency execution. Test a representative production input before choosing the default route.
APIAny© 2026 APIAny. All rights reserved.
