OpenAI · 模型接口

4o Image API

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

文生图图生图

4o Image API 接入文档

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

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

生成4o图像

POST/api/v1/jobs/createTask

模型标识： 4o-image-api

参数	类型	说明与限制
`callBackUrl` 可选	`string`	用于接收4o图像生成任务完成更新的URL地址。可选但推荐在生产环境中使用。 - 系统将在4o图像生成完成时向此URL发送POST请求，包含任务状态和结果 - 回调包含生成的图像URL和任务信息，支持所有变体 - 您的回调端点应能接受包含图像生成结果的JSON载荷的POST请求 - 详细的回调格式和实现指南，请参见 [4o图像生成回调]([see VezAPI documentation]) - 也可以通过[获取任务详情](/cn/market/common/get-task-detail)接口（GET /api/v1/jobs/recordInfo）轮询任务状态。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法
`input` 必填	`object`
`input.file_url` 可选	`string`	（可选，即将废弃）文件URL，例如图片的URL。如果提供file_url，4o image可能会基于该图片进行创作。该参数将在未来被废弃，请使用files_url替代。
`input.files_url` 可选	`array`	（可选）文件URL列表，例如图片URL列表。最多支持5张图片。支持的文件格式：`.jfif`、`.pjpeg`、`.jpeg`、`.pjp`、`.jpg`、`.png`、`.webp`
`input.prompt` 可选	`string`	（可选）提示词，用于描述你希望4o image生成的内容。file_url/files_url和prompt至少需要提供一个
`input.size` 必填	`string`	（必填）图片尺寸比例，必须是支持的格式之一可选值：`"1:1", "3:2", "2:3"`
`model` 必填	`string`	必填，固定为 4o-image-api。可选值：`"4o-image-api"` 默认：`"4o-image-api"`

请求示例

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 '{
  "callBackUrl": "https://example.com/input.png",
  "input": {
    "prompt": "A beautiful sunset over the mountains",
    "size": "1:1"
  },
  "model": "4o-image-api"
}'

返回值与错误

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, 400, 401, 402, 404, 422, 429, 455, 500`
`msg` 可选	`string`	Error message when code != 200
`data` 可选	`object`
`data.taskId` 可选	`string`	Task ID, can be used with [Get Task Details](/market/common/get-task-detail) to query task status

HTTP 500

服务器错误

任务状态与回调

异步任务请保存返回的 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

请求内容

{
  "callBackUrl": "https://example.com/input.png",
  "input": {
    "prompt": "A beautiful sunset over the mountains",
    "size": "1:1"
  },
  "model": "4o-image-api"
}

返回结果

返回结果将在这里显示。

4o Image API 价格

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

规格	积分	计价单位	美元参考
OpenAI 4o image, text-to-image	6.0	每张图片	$0.06