Qwen Image 3.0 Pro Text to Image

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through the Unified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	qwen-image-3.0-pro/text-to-image
Type	Text to image
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

Qwen Image 3.0 Pro Text to Image generates new images through the unified asynchronous API.

Production guidance

In production, prefer callback.url for terminal task notifications.
For exact in-image wording, set prompt_extend to false.

Best suited for

High-fidelity final assets

For final visuals with richer detail, complex materials, and refined layouts.

promptresolution

Format adaptation

Carry the same concept across square, landscape, portrait, and ultrawide layouts.

aspect_ratio

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0-pro/text-to-image",
  "input": {
    "prompt": "A refined architectural photograph of a glass observatory above a quiet ocean at blue hour, luminous interiors, premium editorial lighting, no text.",
    "aspect_ratio": "21:9",
    "resolution": "2K",
    "output_format": "png",
    "prompt_extend": true
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "qwen-image-3.0-pro/text-to-image",
  "input": {
    "prompt": "A refined architectural photograph of a glass observatory above a quiet ocean at blue hour, luminous interiors, premium editorial lighting, no text.",
    "aspect_ratio": "21:9",
    "resolution": "2K",
    "output_format": "png",
    "prompt_extend": true
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "qwen-image-3.0-pro/text-to-image",
  "input": {
    "prompt": "A refined architectural photograph of a glass observatory above a quiet ocean at blue hour, luminous interiors, premium editorial lighting, no text.",
    "aspect_ratio": "21:9",
    "resolution": "2K",
    "output_format": "png",
    "prompt_extend": true
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value qwen-image-3.0-pro/text-to-image.

example qwen-image-3.0-pro/text-to-image

input object required

Model-specific parameter object.

prompt string required

Positive prompt describing image content, style, and composition; up to 18,000 characters.

aspect_ratio enum optional

Width-height ratio of the output image.

default 1:1 enum: 1:13:22:34:33:416:99:1621:9

resolution enum optional

Output resolution tier.

default 1K enum: 1K2K

output_format enum optional

Generated image file format.

default png enum: pngjpeg

prompt_extend boolean optional

Whether to automatically enrich the prompt.

default true

negative_prompt string optional

Content to avoid in the image, up to 500 characters.

default ""

seed integer optional

Random seed from 0 to 2147483647.

callback object optional

Optional callback configuration. In production, pass callback.url for terminal task notifications.

url string required

HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final.

default final enum: final

Example requests

Text-to-image

Uses the verified request structure.

Request body

{
  "model": "qwen-image-3.0-pro/text-to-image",
  "input": {
    "prompt": "A refined architectural photograph of a glass observatory above a quiet ocean at blue hour, luminous interiors, premium editorial lighting, no text.",
    "aspect_ratio": "21:9",
    "resolution": "2K",
    "output_format": "png",
    "prompt_extend": true
  }
}

Getting the result

A successful submission returns a taskId immediately.
In production, prefer callback.url; for local debugging, poll GET /v1/tasks/:id.
When status=success, download the image from output[].url.

FAQ

How should I choose Standard or Pro?

Choose Standard for fast exploration and regular generation; choose Pro for richer detail, complex materials, and final assets.