Qwen Image 3 - PoYo AI

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-3",
  "input": {
    "prompt": "Transform this logo into a polished metallic badge with realistic studio lighting while preserving its recognizable shape and colors",
    "image_urls": [
      "https://storage.poyo.ai/logo.webp"
    ],
    "size": "4:3",
    "resolution": "2K",
    "output_format": "jpeg",
    "prompt_extend": false
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "<string>",
    "status": "not_started",
    "created_time": "2023-11-07T05:31:56Z"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-3",
  "input": {
    "prompt": "Transform this logo into a polished metallic badge with realistic studio lighting while preserving its recognizable shape and colors",
    "image_urls": [
      "https://storage.poyo.ai/logo.webp"
    ],
    "size": "4:3",
    "resolution": "2K",
    "output_format": "jpeg",
    "prompt_extend": false
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "<string>",
    "status": "not_started",
    "created_time": "2023-11-07T05:31:56Z"
  }
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Qwen Image 3 supports text-to-image and multi-reference image generation for posters, product visuals, typography, and natural-language image editing.

Models

qwen-image-3 - Standard image generation with 1K and 2K output
qwen-image-3-pro - Higher-quality image generation with 1K and 2K output

Both models use a unified endpoint. Omit image_urls for text-to-image generation, or provide 1–3 reference images for image-to-image generation.

Required parameters

prompt is required and supports up to 5,000 characters.

Optional parameters

size supports 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, and 21:9.
resolution supports 1K and 2K.
output_format supports png and jpeg.
prompt_extend controls automatic prompt enhancement.
negative_prompt describes content that should not appear in the output.
seed accepts values from 0 to 2,147,483,647.
enable_safety_checker controls content safety checking.

Examples

Pro Text-to-Image Example

{
  "model": "qwen-image-3-pro",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "Create a refined bilingual technology conference poster with the headline Future Vision, elegant grid layout, blue and silver palette, realistic print texture",
    "size": "3:4",
    "resolution": "1K",
    "output_format": "png",
    "negative_prompt": "blurry, distorted typography, watermark",
    "seed": 314159
  }
}

Standard Reference-Image Example

{
  "model": "qwen-image-3",
  "input": {
    "prompt": "Transform this logo into a polished metallic badge with realistic studio lighting while preserving its recognizable shape and colors",
    "image_urls": ["https://storage.poyo.ai/logo.webp"],
    "size": "4:3",
    "resolution": "2K",
    "output_format": "jpeg",
    "prompt_extend": false
  }
}

Pro 2K Reference-Image Example

{
  "model": "qwen-image-3-pro",
  "input": {
    "prompt": "Transform this logo into a premium glass and brushed-metal app icon, preserve the original geometry and colors, dark blue studio background",
    "image_urls": ["https://storage.poyo.ai/logo.webp"],
    "size": "16:9",
    "resolution": "2K",
    "output_format": "png"
  }
}

Pro Multi-Reference Example

{
  "model": "qwen-image-3-pro",
  "input": {
    "prompt": "Combine the original logo geometry from the first reference with the brushed-metal material and lighting from the second reference, centered premium brand emblem",
    "image_urls": [
      "https://storage.poyo.ai/logo.webp",
      "https://storage.poyo.ai/qwen-image-3-pro/reference-material.jpg"
    ],
    "size": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication.

Create an API key: sign in to PoYo, open Dashboard → API Key at poyo.ai/dashboard/api-key, and click to create a key.

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Available options:

qwen-image-3,

qwen-image-3-pro

input

object

required

Show child attributes

callback_url

string<uri>

Response

Task submitted successfully

code

enum<integer>

required

Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.

200: Success
400: Invalid request parameters
401: Missing or invalid API key
402: Insufficient credits
403: Permission denied
404: Resource not found
408: Request timeout
429: Rate limit exceeded
500: Internal server error
502: Upstream service error
503: Service unavailable

See Error Codes for details.

Available options:

200,

400,

401,

402,

403,

404,

408,

429,

500,

502,

503

Example:

200

data

object

required

Show child attributes

​Models

​Required parameters

​Optional parameters

​Examples

​Pro Text-to-Image Example

​Standard Reference-Image Example

​Pro 2K Reference-Image Example

​Pro Multi-Reference Example

Authorizations

Body

Response

Models

Required parameters

Optional parameters

Examples

Pro Text-to-Image Example

Standard Reference-Image Example

Pro 2K Reference-Image Example

Pro Multi-Reference Example