GPT-image 2.0
← 返回 GPT-image 概览,查看版本对比与选型。
GPT-image 2.0 对应模型 ID custom-model-og-v2,通过 TokenHub 路径同步调用,支持文生图与图片编辑。请求返回时结果已包含在响应正文中,无需轮询任务状态。
本页是 GPT-image 系列三篇接口文档之一。版本选型见 GPT-image 2.5 与 GPT-image 2.6。
前提条件
- 已在腾讯云注册账号并开通 TokenHub 服务。
- 您的账号已被开白该模型。
- 已获取 API Key。操作方法:进入【在线推理 - 视觉模型】,搜索
custom-model-og-v2开启后付费,再到 API-Key 管理中为该模型创建 Key。
特别注意
- 该模型为测试使用的模型,需联络后台人员开白才能使用。请联系产品人员,提交 UIN 和 AppId。
- TokenHub 为小时结算周期,请商务注意及时为客户申请折扣。
下文所有示例中的 YOUR_API_KEY 均需替换为您自己的 API Key,鉴权方式为请求头 Authorization: Bearer YOUR_API_KEY。
基本信息
| 项目 | 取值 |
|---|---|
| model | custom-model-og-v2 |
| 支持任务 | 文生图、图片编辑 |
| 请求域名(国际站) | tokenhub-intl.tencentcloudmaas.com(新加坡) |
| 鉴权 | Authorization: Bearer <API_KEY> |
| 结果返回 | 同步,结果包含在响应正文中 |
| 画质档位 | auto / high / medium / low |
| 返回格式 | url / b64_json |
| 是否支持解除安全护栏 | 不支持 |
按地域的接入地址
以上地址以 Singapore 为准。Guangzhou、Silicon Valley 等各地域地址及备用地址请参阅 API 使用指南。
提交文生图任务
1. 接口描述
- 接口请求域名(国际站):
tokenhub-intl.tencentcloudmaas.com国际站新加坡 - 接口:
POST /v1/wand/og-image/generation
根据输入文本,同步生成图片并直接返回生成结果。
2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
model | 是 | String | 模型选择:custom-model-og-v2 |
prompt | 否 | String | 文本描述。最大支持 32,000 字符 |
size | 否 | String | 生成的图像尺寸。支持自定义尺寸(单边 ≤ 3840px,宽高为 16 的倍数,长短边比 ≤ 3:1,总像素 655,360~8,294,400) |
quality | 否 | String | 用于指定将要生成的图像的画质。支持 auto、high、medium、low |
n | 否 | Integer | 生成图片的数量 1~10。默认值:1 |
background | 否 | String | 允许设置生成图像背景的透明度。此参数仅支持 GPT 图像模型。必须是以下值之一:opaque、transparent、auto。如果选择 auto,模型将自动确定图像的最佳背景 |
output_format | 否 | String | 生成图像的返回格式。支持 png、jpeg |
output_compression | 否 | Integer | 生成图像的压缩级别(0-100)。此参数仅支持输出格式为 jpeg 的 GPT 图像模型 |
response_format | 否 | String | 生成的图像的返回格式。可选参数:url 或 b64_json |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
output_format | String | 生成图像的返回格式。示例值:png |
quality | String | 用于指定将要生成的图像的画质。示例值:auto |
size | String | 生成的图像尺寸。示例值:1024x1024 |
background | String | 允许设置生成图像背景的透明度。示例值:auto |
created | Integer | 图像创建的 Unix 时间戳(以秒为单位)。示例值:1776946569 |
data | Array of ResultImage | 生成结果图片列表数据 |
usage | Usage | Token 统计信息 |
request_id | String | 唯一请求 ID,由服务端生成,每次请求都会返回。定位问题时需要提供该次请求的 RequestId |
4. 示例
输入示例
bash
curl --location 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/og-image/generation' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
-d '{
"model": "custom-model-og-v2",
"quality": "low",
"prompt": "小猫跳舞",
"size": "2048x2048",
"n": 1
}'输出示例
json
{
"background": "opaque",
"created": 1786095835,
"data": [
{
"url": "https://xxxxxxxxxxxx.png"
},
{
"url": "https://xxxxxxxxxxxx.png"
}
],
"output_format": "png",
"quality": "low",
"size": "2048x2048",
"usage": {
"total_tokens": 93323
},
"request_id": "eaa4b07b-ccde-40a4-b184-822e3c5a4e60"
}提交图片编辑任务
1. 接口描述
- 接口请求域名:
tokenhub-intl.tencentcloudmaas.com国际站新加坡 - 接口:
POST /v1/wand/og-image/edits(json) - 或:
POST /v1/wand/og-image/multipart-edits(multipart) - 或:
POST /v1/wand/og-image/images/edits(json / multipart)
根据输入图片,同步生成图片并直接返回生成结果。
2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
model | 否 | String | 模型选择:custom-model-og-v2 |
prompt | 是 | String | 文本描述。最大支持 32,000 字符 |
images | 是 | Array of ImageRef | 输入图。支持输入图片数量:1~16 张 |
mask | 否 | ImageRef | 用于局部重绘,尺寸需与输入图片一致 |
size | 否 | String | 生成的图像尺寸。支持自定义尺寸(单边 ≤ 3840px,宽高为 16 的倍数,长短边比 ≤ 3:1,总像素 655,360~8,294,400) |
n | 否 | Integer | 生图数量 1~10。默认值:1 |
quality | 否 | String | 用于指定将要生成的图像的画质。支持 auto、high、medium、low |
background | 否 | String | 允许设置生成图像背景的透明度。此参数仅支持 GPT 图像模型。必须是以下值之一:transparent、opaque 或 auto(默认值)。如果选择 auto,模型将自动确定图像的最佳背景。示例值:auto |
output_format | 否 | String | 生成图像的返回格式。支持 png、jpeg 之一 |
output_compression | 否 | Integer | 生成图像的压缩级别(0-100)。此参数仅支持输出格式为 jpeg 的 GPT 图像模型 |
response_format | 否 | String | 生成的图像的返回格式。可选参数:url 或 b64_json |
transparent 仅在 PNG 中可用
透明背景请使用 background=transparent 搭配 output_format=png。
3. 输出参数
与文生图接口的输出参数一致,见上文。
4. 示例
输入示例(json)
bash
curl --location 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/og-image/edits' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
-d '{
"model": "custom-model-og-v2",
"quality": "low",
"prompt": "跳舞",
"images": [{ "image_url": "https://xxxxxxxxxxxx.png"}],
"size": "2048x2048",
"n": 2
}'输入示例(multipart)
bash
curl --location 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/og-image/multipart-edits' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'model=custom-model-og-v2' \
--form 'prompt=跳舞' \
--form 'image[]=@input.png' \
--form 'n=2' \
--form 'size=2048x2048' \
--form 'quality=low' \
--form 'output_format=png'输出示例
json
{
"background": "opaque",
"created": 1786096322,
"data": [
{
"url": "https://xxxxxxxxxxxx.png"
},
{
"url": "https://xxxxxxxxxxxx.png"
}
],
"output_format": "png",
"quality": "low",
"size": "2048x2048",
"usage": {
"total_tokens": 183284
},
"request_id": "705d12d2-9f68-4cfa-859a-733e449ea675"
}数据结构
ResultImage
| 参数名称 | 类型 | 描述 |
|---|---|---|
url | String | 返回图片的 url |
Usage
| 参数名称 | 类型 | 描述 |
|---|---|---|
total_tokens | Integer | Token 统计信息 |
ImageRef
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
image_url | String | 否 | 图片支持 png、jpg 格式。传图片的 url 地址或 base64 编码数据。示例值:https://xxxxxxxxxxx.png |
计费及价格说明
- 计费模式:按量计费(Token),后付费。
- 结算周期:系统按小时统计并结算您的资源消耗。
- 计价逻辑:费用由 Token 用量和对应单价决定,公式为
总费用 = Token 用量 × Token 单价。 - 用量说明:统一采用
1.6 USD / 百万 token的计费单价,与原厂 token 的数量换算关系见下表。
| Token 类型 | 原厂 USD 单价 | TokenHub 价格 | 转换系数 |
|---|---|---|---|
| text input | $5.00 / 百万 | $1.60 / 百万 | 3.125 |
| text cached | $1.25 / 百万 | $1.60 / 百万 | 0.78125 |
| image input | $8.00 / 百万 | $1.60 / 百万 | 5.0 |
| image cached | $2.00 / 百万 | $1.60 / 百万 | 1.25 |
| image output | $30.00 / 百万 | $1.60 / 百万 | 18.75 |
国际站美元结算逻辑
文本输入token × 3.125
+ 文本缓存输入token × 0.78125
+ 图片输入token × 5
+ 图片缓存输入token × 1.25
+ 输出图片token × 18.75
= 单次任务token消耗相关文档
| 文档 | 说明 |
|---|---|
| GPT-image 2.5 | 新增 xhigh / max 画质档位,支持 markup 标注编辑 |
| GPT-image 2.6 | 新增 complexity 规划档位、GIF 动图与 SVG 矢量输出 |
| API Key 获取 | TokenHub API Key 的申请与管理 |