HiAPI
OverviewModels MarketAPI KeysUsage StatisticsCall LogsBillingReferralPlaygroundStorageChangelogContact UsSettings
Display unit
N
Powered by hiapi
Settings

Welcome

Contact Us

Try Z-Image for low-cost Chinese-friendly portraits, signage, city scenes, and food photography with five ratios, real examples, and API code.

Provider: Alibaba

Category: image generation

Endpoint: /v1/tasks

Status: Available

Cost: See live page pricing

Back to Models

Z-Image

New
by AlibabaImage

Try Z-Image for low-cost Chinese-friendly portraits, signage, city scenes, and food photography with five ratios, real examples, and API code.

Pricing

Standard Usage

16 Credits/ image

Input

0 / 1000
Estimated cost16 Credits / imageper image

Output

Ready for generation

Configure your parameters and click "Run" to see the output here.

--GPU-T4

From product campaigns to detailed scenes

Browse real API results across different aspect ratios, complete prompts, and visual detail.

Related image models

Choose an adjacent model by task, output tier, and reference-image needs.

Fast commercial generation

FLUX.2 [klein] 9B

Compare four-step output, readable English text, seed control, and low per-image cost.

Fast 2K/4K generation

Seedream 5.0 Lite

A flat-price option for multilingual commercial visuals and rapid iteration.

Higher-end Chinese generation

Qwen Image 2.0 Pro

Use the Pro route for Chinese typography, larger size presets, and prompt extension.

Compare AI image APIs

About Z-Image

Try Z-Image for low-cost Chinese-friendly portraits, signage, city scenes, and food photography with five ratios, real examples, and API code.

The Playground and API use the same model ID: z-image. This endpoint accepts text prompts only; reference-image editing uses the separate Image-to-Image route.

Provider
Alibaba
Task
Text-to-Image
References
Not supported
Pricing
16 Credits / image

Model specifications

These specifications reflect the current Z-Image request contract.

Reference images
Not supported
Aspect ratios
1:14:33:416:99:16
Prompt length
Up to 1000 characters
Pricing
Per image: 16 Credits / image

Final cost depends on the output tier and input add-ons. Check the live page price and task record for the final charge.

How to use Z-Image

Choose the destination and aspect ratio before composing subject, scene, material, light, and text.

Subject
Scene
Camera and light
01

Describe subject and scene

API Quickstart

Copy a minimal request below. See Docs for parameters, callbacks, task retrieval, and errors.

Endpoint
POST /v1/tasks
Model ID
z-image
cURL
curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image",
  "input": {
    "prompt": "A cinematic product campaign with sharp text",
    "aspect_ratio": "1:1"
  }
}'

The create request immediately returns a taskId; image generation continues asynchronously.

Read the full API documentation

Frequently asked questions

What is Z-Image best for?

Low-cost Chinese-prompt generation, realistic portraits, signage, urban nights, and food assets.

Which aspect ratios are supported?

1:1, 4:3, 3:4, 16:9, and 9:16.

Can I control resolution or format?

The current public contract exposes only prompt and aspect_ratio. Do not add undeclared resolution or format fields.

Does it accept reference images?

No. The current Z-Image model ID is text-to-image only.

How do I call the API?

POST /v1/tasks with model: z-image and input.prompt. aspect_ratio is optional.

Start with the subject, environment, and visual goal, then add material, light, camera, and exact text.

Draft

4 steps

Final

8 steps

02

Choose output settings

Choose one of five common aspect ratios and keep the request focused on the prompt.

Playground
POST /v1/tasks
03

Validate before integration

Confirm the result in Playground, then reuse the same prompt and model ID in an asynchronous task.