Text to Image

POST

https://api.piapi.ai/api/v1/task

This is provided as z-image API. available models:

txt2img

Pricing

$0.002 per 0.5 Mega Pixels

1 Mega Pixels = 1024*1024 pixels

total price = price*batch_size

output image pixels	price
pixels <= 0.5MP	$0.002
0.5MP < pixels <= 1MP	$0.004
1MP < pixels <= 1.5MP	$0.006
1.5MP < pixels	$0.008

Note

recommand size is 1024*1024

step is fixed to 9

batch generation is faster

Request

Header Params

Body Params application/json

Example

{
    "model": "Qubico/z-image",
    "task_type": "txt2img",
    "input": {
        "prompt": "a bear",
        "negative_prompt": "blurry",
        "flow_shift": 3.0,
        "width": 1024,
        "height": 1024,
        "batch_size": 1,
        "seed": -1
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/20d9b15f-bfb8-4237-8e4a-993f462f9eb9",
            "secret": ""
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "Qubico/z-image",
    "task_type": "txt2img",
    "input": {
        "prompt": "a bear",
        "negative_prompt": "blurry",
        "flow_shift": 3.0,
        "width": 1024,
        "height": 1024,
        "batch_size": 1,
        "seed": -1
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://webhook.site/20d9b15f-bfb8-4237-8e4a-993f462f9eb9",
            "secret": ""
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "20cec6db-2fd9-438a-8fac-2c6abf7f846a",
        "model": "Qubico/z-image",
        "task_type": "txt2img",
        "status": "pending",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/20d9b15f-bfb8-4237-8e4a-993f462f9eb9",
                "secret": ""
            }
        },
        "input": {
            "prompt": "a bear",
            "negative_prompt": "blurry",
            "width": 1024,
            "height": 1024,
            "seed": -1,
            "flow_shift": 3,
            "batch_size": 1
        },
        "output": null,
        "meta": {
            "created_at": "2025-12-23T11:15:27.238414275Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 40000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Modified at 2025-12-23 11:24:13

Get task