Imagen 4 API 接入文档
使用 VezAPI 密钥接入 Imagen 4。下列操作共用同一个账号余额和鉴权方式。
https://api.vezapi.com请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key,查询同一笔提交时才复用。
Google Imagen4 Fast
/api/v1/jobs/createTask模型标识: google/imagen4-fast
| 参数 | 类型 | 说明与限制 |
|---|---|---|
model必填 | string | 用于生成任务的模型名称。必填字段。 - 该端点必须使用 `google/imagen4-fast` 模型 可选值: 默认: |
callBackUrl可选 | string | 接收生成任务完成通知的回调 URL。可选配置,建议在生产环境中使用。 - 任务生成完成后,系统会向该 URL POST 任务状态与结果 - 回调内容包含生成的资源 URL 与任务相关信息 - 您的回调端点需要支持接收带 JSON 负载的 POST 请求 - 也可以选择调用任务详情端点,主动轮询任务状态 - 为确保回调安全性,请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法 |
input可选 | object | 生成任务的输入参数 |
input.prompt必填 | string | 用于描述生成图像内容的文本提示词(最大长度:5000 字符)
|
input.negative_prompt可选 | string | 用于描述生成图像中需要规避的元素的文本(最大长度:5000 字符)
|
input.aspect_ratio必填 | string | 必填。输出图像宽高比:1:1、16:9、9:16、3:4、4:3 或 auto。 可选值: |
input.seed可选 | integer | 用于生成结果可复现的随机种子值 |
请求示例
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": "google/imagen4-fast",
"input": {
"prompt": "Create a cinematic, photorealistic medium shot capturing the nostalgic warmth of a late 90s indie film. The focus is a young woman with brightly dyed pink hair (slightly faded) and freckled skin, looking directly and intently into the camera lens with a hopeful yet slightly uncertain smile. She wears an oversized, vintage band t-shirt (slightly worn, with the faintly cracked white text “KIE AI” across the chest) layered over a long-sleeved striped top, along with simple silver stud earrings. The lighting is soft, golden hour sunlight streaming through a slightly dusty window, creating lens flare and illuminating dust motes in the air. The background shows a blurred, cluttered bedroom with posters on the wall and fairy lights, rendered with a shallow depth of field. Natural film grain, a warm, slightly muted color palette, and sharp focus on her expressive eyes enhance the intimate, authentic feel.",
"aspect_ratio": "16:9"
}
}'返回值与错误
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). 可选值: |
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. |
HTTP 500
响应字段与业务状态码。
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code必填 | integer | 业务状态码:200 请求成功;401 鉴权凭据缺失或无效;402 积分不足;404 资源或接口不存在;408 超过 10 分钟未返回结果;422 参数校验失败;429 请求频率超限;455 系统维护;500 处理请求时发生内部错误;501 内容生成失败;505 功能当前关闭。 |
msg必填 | string | 响应消息;失败时说明错误原因。 |
data必填 | object |
Google Imagen4 Ultra
/api/v1/jobs/createTask模型标识: google/imagen4-ultra
| 参数 | 类型 | 说明与限制 |
|---|---|---|
model必填 | string | 用于生成任务的模型名称。必填字段。 - 该端点必须使用 `google/imagen4-ultra` 模型 可选值: 默认: |
callBackUrl可选 | string | 接收生成任务完成通知的回调 URL。可选配置,建议在生产环境中使用。 - 任务生成完成后,系统会向该 URL POST 任务状态与结果 - 回调内容包含生成的资源 URL 与任务相关信息 - 您的回调端点需要支持接收带 JSON 负载的 POST 请求 - 也可以选择调用任务详情端点,主动轮询任务状态 - 为确保回调安全性,请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法 |
input可选 | object | 生成任务的输入参数 |
input.prompt必填 | string | 用于描述生成图像内容的文本提示词(最大长度:5000 字符)
|
input.negative_prompt可选 | string | 用于描述生成图像中需要规避的元素的文本(最大长度:5000 字符)
|
input.aspect_ratio必填 | string | 必填。输出图像宽高比:1:1、16:9、9:16、3:4、4:3 或 auto。 可选值: |
input.seed可选 | string | 用于生成结果可复现的随机种子值(最大长度:500 字符)
|
请求示例
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": "google/imagen4-ultra",
"input": {
"prompt": "A lively comic scene where two colleagues are in an office. The first person says, '\''Have you heard about Google Imagen 4 Ultra?'\'' The second person responds with excitement, '\''It’s the best text-to-image tool out there!'\'' The first person asks again, '\''Do you know where to get the API?'\'' The second person smiles and says, '\''Kie.ai has it!'\'' In the final panel, the two look at a screen showing Kie.ai’s interface with an API option, with bright and colorful comic-style illustrations.",
"aspect_ratio": "1:1"
}
}'返回值与错误
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). 可选值: |
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. |
HTTP 500
响应字段与业务状态码。
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code必填 | integer | 业务状态码:200 请求成功;401 鉴权凭据缺失或无效;402 积分不足;404 资源或接口不存在;408 超过 10 分钟未返回结果;422 参数校验失败;429 请求频率超限;455 系统维护;500 处理请求时发生内部错误;501 内容生成失败;505 功能当前关闭。 |
msg必填 | string | 响应消息;失败时说明错误原因。 |
data必填 | object |
Google Imagen4
/api/v1/jobs/createTask模型标识: google/imagen4
| 参数 | 类型 | 说明与限制 |
|---|---|---|
model必填 | string | 用于生成任务的模型名称。必填字段。 - 该端点必须使用 `google/imagen4` 模型 可选值: 默认: |
callBackUrl可选 | string | 接收生成任务完成通知的回调 URL。可选配置,建议在生产环境中使用。 - 任务生成完成后,系统会向该 URL POST 任务状态与结果 - 回调内容包含生成的资源 URL 与任务相关信息 - 您的回调端点需要支持接收带 JSON 负载的 POST 请求 - 也可以选择调用任务详情端点,主动轮询任务状态 - 为确保回调安全性,请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法 |
input可选 | object | 生成任务的输入参数 |
input.prompt必填 | string | 用于描述生成图像内容的文本提示词(最大长度:5000 字符)
|
input.negative_prompt可选 | string | 用于描述生成图像中需要规避的元素的文本(最大长度:5000 字符)
|
input.aspect_ratio必填 | string | 必填。输出图像宽高比:1:1、16:9、9:16、3:4、4:3 或 auto。 可选值: |
input.seed可选 | string | 用于生成结果可复现的随机种子值(最大长度:500 字符)
|
请求示例
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": "google/imagen4",
"input": {
"prompt": "A lively comic scene where two colleagues are in an office. The first person says, '\''Have you heard about Google Imagen 4 Ultra?'\'' The second person responds with excitement, '\''It’s the best text-to-image tool out there!'\'' The first person asks again, '\''Do you know where to get the API?'\'' The second person smiles and says, '\''Kie.ai has it!'\'' In the final panel, the two look at a screen showing Kie.ai’s interface with an API option, with bright and colorful comic-style illustrations.",
"aspect_ratio": "1:1"
}
}'返回值与错误
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). 可选值: |
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. |
HTTP 500
响应字段与业务状态码。
| 参数 | 类型 | 说明与限制 |
|---|---|---|
code必填 | integer | 业务状态码:200 请求成功;401 鉴权凭据缺失或无效;402 积分不足;404 资源或接口不存在;408 超过 10 分钟未返回结果;422 参数校验失败;429 请求频率超限;455 系统维护;500 处理请求时发生内部错误;501 内容生成失败;505 功能当前关闭。 |
msg必填 | string | 响应消息;失败时说明错误原因。 |
data必填 | object |
任务状态与回调
异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询,或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。
超时可能表示请求已经受理。请在控制台查看原请求,不要自动新建任务。回调可能重试并重复到达,请使用 X-VezAPI-Event-Id 去重。
文件、日志与计费
生成媒体通常随上游保留 14 天,上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源,不提供永久作品库。请求日志保留两个自然月。
调用前预留积分,最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算,会保留待结算记录,补足余额后再扣费;模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长,读取失败时不提交模型任务。