Z-Image API Playground

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

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

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