Z-Image API Playground
Generate stunning AI images with our powerful Z-Image API
Showcase Gallery
Explore stunning AI-generated images created with Z-Image API.
Pirate ship trapped in a cosmic maelstrom nebula, rendered in cosmic beach whirlpool engine, volumetric lighting, spectacular, ambient lights, light pollution, cinematic atmosphere, art nouveau style, illustration art artwork by SenseiJaye, intricate detail.
cute anime girl with massive fennec ears and a big fluffy fox tail with long wavy blonde hair between eyes and large blue eyes blonde colored eyelashes chubby wearing oversized clothes summer uniform long blue maxi skirt muddy clothes happy sitting on the side of the road in a run down dark gritty cyberpunk city with neon and a crumbling skyscraper in the rain at night while dipping her feet in a river of water she is holding a sign that says "FoxAIHub is awesome" written in cursive
古风美人，面容精致美丽，手拿汝瓷杯，优雅喝茶，茶席上有茶壶茶杯茶叶插花，精致的茶席布置，环境优美，丰富细节，光斑点缀， 人像摄影，日常快照风格，非精心构图或打光，神情忧郁妖冶少女，冷白皮，瓜子脸尖下巴，皮肤白皙，底妆通透，肤色均匀自然，纯欲风。，发丝清晰可见,皮肤白皙，底妆通透，肤色均匀自然，纯欲风。光线柔和自然，非均匀打光，表情自然松弛，照片毫无修饰感，带有生活真实感。ccd拍照感，iphone实拍，真人，真实生活
Ink painting, use simple ink painting to draw a very powerful black horse
Modern sofa, with cushions and armrests, minimalist design, clean lines, white background, modern furniture, simple and elegant, neutral color matching, modern interior design, pillows on the sofa.
Resin drop pendant embedded with dried flowers and gold leaves, translucent light under soft box, black matte base, fine dust particles under edge light, handmade gallery photos
a stunning watercolor painting on canvas of a beautiful woman, in the style of Claude Monet ::1 4 lavender fields, impressionism, impressionistic landscapes, pastel colors, impressionistic portraits ::1 3 exaggerated blurry brushstrokes
A bluebird, stencil
1girl, hatsune miku, dress, long hair, jewelry, white dress, blue eyes, necklace, bubble, solo, underwater, hair between eyes, looking at viewer, bangs, blue hair, bow, reaching towards viewer, blue theme, air bubble, hair bow, collarbone, floating hair, frills, twintails, blurry foreground, frilled dress, off-shoulder dress, bare shoulders, blurry, very long hair,masterpiece,best quality,amazing quality,
Why Choose FoxAIHub?
Half the price, double the value
| Provider | Cost per Megapixel | Speed | $1 Gets You |
|---|---|---|---|
| fal.ai | $0.005 | 1.56s | 200 images |
| Replicate | $0.005 | 2.12s | 200 images |
 FoxAIHubBEST | $0.0025(-50%) | 2.51s | 400 images(2x) |
FoxAIHub* Generation speed depends on the steps parameter. Higher steps produce clearer, higher-quality images but take longer to generate.
Z Image API Document
Basic API Configuration
Base URL: https://api.foxaihub.com/api/v2
Headers Parameters:
{
"api-key": "Your API Key"
}
:::warning
The parameter is api-key instead of api_key.
:::
Pricing
$0.0025 per generation
Notes
The images generated by this API will only be saved for 24 hours, after which they will be deleted by the system. At that time, you will not be able to access the image via the URL.
Z Image Turbo Task
Path: /aigc/task
Method: POST
Type: application/json
Parameters
| Parameter Name | Type | Description | Remarks |
|---|---|---|---|
| task_type | String | Task type identifier | Required. Must be "z_image_turbo" |
| params | Object | Generation parameters object | Required |
| params.prompt | String | Text prompt used to guide the image generation process | Required |
| params.negative_prompt | String | Text describing elements to exclude from the generated image | Optional. Default: "" |
| params.height | Number | Desired height, in pixels, of the generated image | Required. Recommended: [1, 1536] |
| params.width | Number | Desired width, in pixels, of the generated image | Required. Recommended: [1, 1536] |
| params.steps | Number | Number of denoising iterations the diffusion model will run | Optional. Default: 5 |
| batch_size | Number | How many separate images to produce per request | Optional. Valid range: [1, 4]. Default: 1 |
The range of Steps is 4-9. Higher steps result in slower image generation, but also higher image quality.
Example Request
POST {{base_url}}/aigc/task HTTP/1.1
Content-Type: application/json
api-key: {{api_key}}
{
"task_type": "z_image_turbo",
"params": {
"prompt": "Pirate ship trapped in a cosmic maelstrom nebula, rendered in cosmic beach whirlpool engine, volumetric lighting, spectacular, ambient lights, light pollution, cinematic atmosphere, art nouveau style, illustration art artwork by SenseiJaye, intricate detail.",
"negative_prompt": "",
"height": 1024,
"width": 1024,
"steps": 5
},
"batch_size": 2
}
Example Response
{
"success": true,
"task_id": "019add2a-9e3e-7000-96bd-cee7b41bdd2f"
}
Query Task Status
Path: /aigc/task
Method: GET
Type: application/json
Query Parameters
| Parameter Name | Type | Description | Remarks |
|---|---|---|---|
| ids | String | Task ID(s) to query. Multiple IDs can be comma-separated | Required |
Example Request
GET {{base_url}}/aigc/task?ids=019add29-ab83-7000-81e1-8d93c6cbaebb HTTP/1.1
Content-Type: application/json
api-key: {{api_key}}
Example Response (Processing)
[
{
"id": 16186,
"user_id": 1,
"task_id": "019add29-ab83-7000-81e1-8d93c6cbaebb",
"task_type": "z_image_turbo",
"status": "processing",
"params": {
"steps": 5,
"width": 1024,
"height": 1024,
"prompt": "Pirate ship trapped in a cosmic maelstrom nebula, rendered in cosmic beach whirlpool engine, volumetric lighting, spectacular, ambient lights, light pollution, cinematic atmosphere, art nouveau style, illustration art artwork by SenseiJaye, intricate detail.",
"batch_size": 2,
"negative_prompt": ""
},
"data": null,
"data1": null,
"data2": null,
"priority": 0,
"created_at": "2025-12-02T03:44:47.000Z"
}
]
Example Response (Completed)
[
{
"id": 16186,
"user_id": 1,
"task_id": "019add29-ab83-7000-81e1-8d93c6cbaebb",
"task_type": "z_image_turbo",
"status": "completed",
"params": {
"steps": 5,
"width": 1024,
"height": 1024,
"prompt": "Pirate ship trapped in a cosmic maelstrom nebula, rendered in cosmic beach whirlpool engine, volumetric lighting, spectacular, ambient lights, light pollution, cinematic atmosphere, art nouveau style, illustration art artwork by SenseiJaye, intricate detail.",
"batch_size": 2,
"negative_prompt": ""
},
"data": [
"https://cdnfy.foxai.me/019add29-ab83-7000-81e1-8d93c6cbaebb_0.png",
"https://cdnfy.foxai.me/019add29-ab83-7000-81e1-8d93c6cbaebb_1.png"
],
"data1": null,
"data2": null,
"priority": 0,
"created_at": "2025-12-02T03:44:47.000Z"
}
]
Task Status Values
| Status | Description |
|---|---|
processing |
Task is currently being processed |
completed |
Task has finished successfully, image URLs available in data array |
failed |
Task failed to complete |
Recommended Image Resolutions
Following the 64-pixel alignment principle for optimal AI image generation quality and compatibility.
Standard Resolution (1K)
Long edge fixed at 1024px, short edge scaled proportionally to the nearest multiple of 64.
| Ratio | Resolution | Pixels | Use Case |
|---|---|---|---|
| 1:1 | 1024 x 1024 | 1.05M | Avatars, Social Media |
| 4:3 | 1024 x 768 | 0.78M | Traditional Displays, Tablets |
| 3:4 | 768 x 1024 | 0.78M | Portraits, Poster Previews |
| 16:9 | 1024 x 576 | 0.59M | Desktop Wallpapers, Video Thumbnails |
| 9:16 | 576 x 1024 | 0.59M | Mobile Wallpapers, Stories |
High Resolution (2K)
Long edge fixed at 2048px for finer detail, ideal for printing and high-resolution displays.
| Ratio | Resolution | Pixels | Use Case |
|---|---|---|---|
| 1:1 | 2048 x 2048 | 4.19M | HD Artwork, Commercial Assets |
| 4:3 | 2048 x 1536 | 3.14M | Presentations, Photo Albums |
| 3:4 | 1536 x 2048 | 3.14M | Magazine Covers, HD Portraits |
| 16:9 | 2048 x 1152 | 2.36M | 4K Display, Video Production |
| 9:16 | 1152 x 2048 | 2.36M | HD Mobile Wallpapers, App Splash Screens |
Frequently Asked Questions
Everything you need to know about Z-Image API.