Qwen · 模型接口

Qwen Image 3.0 API 价格与接入

Qwen Image 3.0 API 的模型能力、计价规格、请求参数和接入示例。使用 VezAPI 账号密钥统一接入。

文生图图生图

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 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。

打开完整文档 →

使用你的 VezAPI 密钥发送请求。成功生成将消耗账号积分。

VezAPI API Key

POST/api/v1/jobs/createTask

请求内容

{
  "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"
  }
}

返回结果

返回结果将在这里显示。

Qwen Image 3.0 API 价格

下方费率为参考估算，最终按实际优惠扣分 1:1 结算。按标准充值包换算，1,000 积分约为 10 美元，大额充值包可降低每积分实际单价。

规格	积分	计价单位	美元参考
Qwen image 3.0 Pro, output, 2K	12	每张图片	$0.12
Qwen image 3.0 Pro, output, 1K	6.4	每张图片	$0.064
Qwen image 3.0 Pro, input, 2K	0.5	每张图片	$0.005
Qwen image 3.0 Pro, input, 1K	0.5	每张图片	$0.005
Qwen image 3.0 Pro, text to image, 2K	12	每张图片	$0.12
Qwen image 3.0 Pro, text to image, 1K	6.4	每张图片	$0.064
Qwen image 3.0, output, 2K	4.8	每张图片	$0.048
Qwen image 3.0, output, 1K	4.8	每张图片	$0.048
Qwen image 3.0, input, 2K	0.5	每张图片	$0.005
Qwen image 3.0, input, 1K	0.5	每张图片	$0.005
Qwen image 3.0, text to image, 2K	4.8	每张图片	$0.048
Qwen image 3.0, text to image, 1K	4.8	每张图片	$0.048