跳至正文
EN
获取 API Key
☰

Qwen Image 3.0 API 接入文档

使用 VezAPI 密钥接入 Qwen Image 3.0。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Qwen3 Pro 图生图

POST/api/v1/jobs/createTask

模型标识： qwen3/pro-image-to-image

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。该字段为必填项。此接口必须使用 `qwen3/pro-image-to-image` 模型。

可选值："qwen3/pro-image-to-image"

默认："qwen3/pro-image-to-image"

callBackUrl
可选		string

任务完成通知的回调 URL。该参数为可选项。如果提供，当任务完成时，无论成功或失败，系统都会向该 URL 发送 POST 请求。如果未提供，则不会发送回调通知。

input
必填		object

图生图任务的输入参数。

input.image_urls
必填		array

输入图片 URL 数组。请上传图片并提供上传后的文件 URL，而不是文件内容。最多支持 3 张图片。支持的文件类型：`image/jpeg`、`image/png`、`image/webp`、`image/bmp`、`image/tiff` 和 `image/gif`。每张图片最大 10 MB。

minItems: 1

maxItems: 3

input.prompt
必填		string

描述希望生成或编辑的图像内容、风格和构图的正向提示词。支持中文和英文。

minLength: 1

maxLength: 5000

input.resolution
可选		string

输出图片分辨率。

可选值："1K", "2K"

默认："1K"

input.image_size
可选		string

输出图片比例。

可选值："1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"

默认："16:9"

input.output_format
可选		string

输出格式：png 或 jpeg。请显式传入。

可选值："png", "jpeg"

input.prompt_extend
可选		boolean

是否启用智能提示词改写。默认值：true（推荐）。启用后，模型会优化正向提示词，可显著提升简单描述的生成效果。

默认：true

input.negative_prompt
可选		string

描述不希望出现在图片中的内容的负向提示词。

minLength: 0

maxLength: 5000

input.seed
可选		integer

随机种子，取值 0–2147483647。不传则随机。

minimum: 0

maximum: 2147483647

input.nsfw_checker
可选		boolean

是否启用内容过滤。可选参数，默认值为 false。设置为 false 时，将关闭内容过滤，模型生成的所有结果会被直接返回。注意：内容过滤无法保证检测出所有不当内容；如果过滤结果不能满足您的要求，您需要自行采取额外的内容审核措施。

默认：false

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "qwen3/pro-image-to-image",
  "input": {
    "image_urls": [
      "https://example.com/input.png"
    ],
    "prompt": "Turn the input image into a cinematic watercolor illustration.",
    "resolution": "1K"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Qwen3 Pro 文生图

POST/api/v1/jobs/createTask

模型标识： qwen3/pro-text-to-image

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。该字段为必填项。此接口必须使用 `qwen3/pro-text-to-image` 模型。

可选值："qwen3/pro-text-to-image"

默认："qwen3/pro-text-to-image"

callBackUrl
可选		string

任务完成通知的回调 URL。该参数为可选项。如果提供，当任务完成时，无论成功或失败，系统都会向该 URL 发送 POST 请求。如果未提供，则不会发送回调通知。

input
必填		object

文生图任务的输入参数。

input.prompt
必填		string

描述希望生成的图像内容、风格和构图的正向提示词。支持中文和英文。

minLength: 1

maxLength: 5000

input.resolution
可选		string

输出图片分辨率。

可选值："1K", "2K"

默认："1K"

input.image_size
可选		string

输出图片比例。

可选值："1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"

默认："16:9"

input.output_format
可选		string

输出格式：png 或 jpeg。请显式传入。

可选值："png", "jpeg"

input.prompt_extend
可选		boolean

是否启用智能提示词改写。默认值：true（推荐）。启用后，模型会优化正向提示词，可显著提升简单描述的生成效果。

默认：true

input.negative_prompt
可选		string

描述不希望出现在图片中的内容的负向提示词。

minLength: 0

maxLength: 5000

input.seed
可选		integer

随机种子，取值 0–2147483647。不传则随机。

minimum: 0

maximum: 2147483647

input.nsfw_checker
可选		boolean

是否启用内容过滤。可选参数，默认值为 false。设置为 false 时，将关闭内容过滤，模型生成的所有结果会被直接返回。注意：内容过滤无法保证检测出所有不当内容；如果过滤结果不能满足您的要求，您需要自行采取额外的内容审核措施。

默认：false

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "qwen3/pro-text-to-image",
  "input": {
    "prompt": "A futuristic city at sunset, cinematic lighting, ultra detailed.",
    "resolution": "1K"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Qwen3 图生图

POST/api/v1/jobs/createTask

模型标识： qwen3/image-to-image

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。该字段为必填项。此接口必须使用 `qwen3/image-to-image` 模型。

可选值："qwen3/image-to-image"

默认："qwen3/image-to-image"

callBackUrl
可选		string

任务完成通知的回调 URL。该参数为可选项。如果提供，当任务完成时，无论成功或失败，系统都会向该 URL 发送 POST 请求。如果未提供，则不会发送回调通知。

input
必填		object

图生图任务的输入参数。

input.image_urls
必填		array

输入图片 URL 数组。请上传图片并提供上传后的文件 URL，而不是文件内容。最多支持 3 张图片。支持的文件类型：`image/jpeg`、`image/png`、`image/webp`、`image/bmp`、`image/tiff` 和 `image/gif`。每张图片最大 10 MB。

minItems: 1

maxItems: 3

input.prompt
必填		string

描述希望生成或编辑的图像内容、风格和构图的正向提示词。支持中文和英文。

minLength: 1

maxLength: 5000

input.resolution
可选		string

输出图片分辨率。

可选值："1K", "2K"

默认："1K"

input.image_size
可选		string

输出图片比例。

可选值："1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"

默认："16:9"

input.output_format
可选		string

输出格式：png 或 jpeg。请显式传入。

可选值："png", "jpeg"

input.prompt_extend
可选		boolean

是否启用智能提示词改写。默认值：true（推荐）。启用后，模型会优化正向提示词，可显著提升简单描述的生成效果。

默认：true

input.negative_prompt
可选		string

描述不希望出现在图片中的内容的负向提示词。

minLength: 0

maxLength: 5000

input.seed
可选		integer

随机种子，取值 0–2147483647。不传则随机。

minimum: 0

maximum: 2147483647

input.nsfw_checker
可选		boolean

是否启用内容过滤。可选参数，默认值为 false。设置为 false 时，将关闭内容过滤，模型生成的所有结果会被直接返回。注意：内容过滤无法保证检测出所有不当内容；如果过滤结果不能满足您的要求，您需要自行采取额外的内容审核措施。

默认：false

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "qwen3/image-to-image",
  "input": {
    "image_urls": [
      "https://example.com/input.png"
    ],
    "prompt": "Turn the input image into a cinematic watercolor illustration.",
    "resolution": "1K"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

Qwen3 文生图

POST/api/v1/jobs/createTask

模型标识： qwen3/text-to-image

参数类型说明与限制
model
必填		string

用于生成任务的模型名称。该字段为必填项。此接口必须使用 `qwen3/text-to-image` 模型。

可选值："qwen3/text-to-image"

默认："qwen3/text-to-image"

callBackUrl
可选		string

任务完成通知的回调 URL。该参数为可选项。如果提供，当任务完成时，无论成功或失败，系统都会向该 URL 发送 POST 请求。如果未提供，则不会发送回调通知。

input
必填		object

文生图任务的输入参数。

input.prompt
必填		string

描述希望生成的图像内容、风格和构图的正向提示词。支持中文和英文。

minLength: 1

maxLength: 5000

input.resolution
可选		string

输出图片分辨率。

可选值："1K", "2K"

默认："1K"

input.image_size
可选		string

输出图片比例。

可选值："1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"

默认："16:9"

input.output_format
可选		string

输出格式：png 或 jpeg。请显式传入。

可选值："png", "jpeg"

input.prompt_extend
可选		boolean

是否启用智能提示词改写。默认值：true（推荐）。启用后，模型会优化正向提示词，可显著提升简单描述的生成效果。

默认：true

input.negative_prompt
可选		string

描述不希望出现在图片中的内容的负向提示词。

minLength: 0

maxLength: 5000

input.seed
可选		integer

随机种子，取值 0–2147483647。不传则随机。

minimum: 0

maximum: 2147483647

input.nsfw_checker
可选		boolean

是否启用内容过滤。可选参数，默认值为 false。设置为 false 时，将关闭内容过滤，模型生成的所有结果会被直接返回。注意：内容过滤无法保证检测出所有不当内容；如果过滤结果不能满足您的要求，您需要自行采取额外的内容审核措施。

默认：false

请求示例
curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "qwen3/text-to-image",
  "input": {
    "prompt": "A futuristic city at sunset, cinematic lighting, ultra detailed.",
    "resolution": "1K"
  }
}'
返回值与错误

HTTP 200

请求成功

参数类型说明与限制
code
可选		integer

Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying).

可选值：200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505

msg
可选		string

Response message, error description upon failure

data
必填		object
data.taskId
必填		string

The task ID can be used with the "Get Task Details" endpoint to query the task status.

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。