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"
}
}Alibaba
Qwen Image 3
Qwen Image 3 API 根据文本或一到三张参考图生成图像，包括 Qwen Image 3 Pro。两者都支持 1K 和 2K 输出、反向提示词和自然语言编辑。
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"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- qwen-image-3 - 标准图像生成，支持 1K 和 2K 输出
- qwen-image-3-pro - 更高质量的图像生成，支持 1K 和 2K 输出
image_urls，图生图时提供 1–3 张参考图。
必填参数
prompt必填，最多支持 5,000 个字符。
可选参数
size支持1:1、3:2、2:3、4:3、3:4、16:9、9:16和21:9。resolution支持1K和2K。output_format支持png和jpeg。prompt_extend控制自动提示词增强。negative_prompt描述不应出现在输出中的内容。seed接受 0 到 2,147,483,647 之间的值。enable_safety_checker控制内容安全检查。
示例
Pro 文生图示例
{
"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
}
}
标准版参考图示例
{
"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 参考图示例
{
"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 多参考图示例
{
"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"
}
}
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes