Skip to main content
POST
Generate image with Qwen Image 3.0 Pro

Qwen Image 3.0 Pro on BudgetPixel

More examples, prompts and pricing.

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Text description of the image to generate. Write @handle to cast a character: a BudgetPixel AI influencer or one of your own (GET /v1/characters).

aspect_ratio
enum<string>
default:1:1

Output aspect ratio.

Available options:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3,
21:9,
match_input_image
negative_prompt
string

What to avoid in the generated image.

num_images
integer
default:1

Number of images to generate.

Required range: 1 <= x <= 4
reference_images
string[]

Optional reference images (up to 3) for image editing and multi-image fusion. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-image. Use aspect_ratio "match_input_image" to keep the input's aspect ratio.

Maximum array length: 3
seed
integer

Seed for reproducible generation. Omit for random.

size
enum<string>
default:1K

Output resolution tier. 1K bills 45 credits per image; 2K bills 85.

Available options:
1K,
2K

Response

Job accepted.

characters
object[]

The characters the prompt cast with @handle mentions. Absent when none.

id
string

Opaque job id — use it to poll status.

Example:

"img_a1b2c3d4e5f6"

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout