GPT-Image 2.0 โ
โ Back to the GPT-Image overview for a version comparison and selection guide.
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask
GPT-Image 2.0 is the base version of the family: one series, three quality tiers, and the simplest parameters. It is also the default series when ModelVersion is omitted (default value image2_medium).
This page is one of three GPT-Image API documents. See also GPT-Image 2.5 and GPT-Image 2.6. If you need the higher xhigh / max tiers, or want to choose between speed and precision, use the two variants in 2.5 / 2.6.
Basic information โ
| Item | Value |
|---|---|
| ModelName | OG |
| ModelVersion | image2_low / image2_medium / image2_high |
| Defaults | ModelVersion=image2_medium / AspectRatio=1:1 |
| Result polling | DescribeTaskDetail |
| Guardrail bypass | Not supported |
ModelVersion enumeration โ
| ModelVersion | Characteristics | Recommended for |
|---|---|---|
image2_low | Fastest generation, lowest cost | Quick drafts, batch testing, prompt iteration |
image2_medium | The sweet spot between speed, cost, and quality (default) | Most day-to-day production and general design work |
image2_high | Slowest and most expensive; the most refined detail, texture, lighting and shadow, and strong on complex text and small type | Final deliverables, print material, high-precision product shots |
2.0 tops out at high
The xhigh and max tiers arrive with 2.5. If you need higher fidelity, or want to choose between sunburst (precision) and flare (speed), switch to 2.5 / 2.6.
Request parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
SubAppId | Yes | Integer | Subapplication ID |
ModelName | Yes | String | Fixed value OG |
ModelVersion | No | String | image2_low / image2_medium / image2_high. Defaults to image2_medium when omitted |
Prompt | Yes | String | Generation prompt, up to 32,000 characters |
FileInfos.N | No | Array | Reference images (image-to-image), up to 16. Acts as a mask when ReferenceType=mask. See Passing reference images |
OutputConfig.StorageMode | No | String | Temporary (7-day retention) / Permanent (returns a FileId) |
OutputConfig.Resolution | No | String | 1K / 2K / 4K |
OutputConfig.AspectRatio | No | String | 1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 16:9 / 9:16 / 21:9 / 9:21 |
OutputConfig.OutputImageCount | No | Integer | Number of images; 1โ8 for OG |
OutputConfig.OutputFormat | No | String | jpeg / png. Follows the model default when omitted. GIF / SVG output is 2.6 only |
OutputConfig.PersonGeneration | No | String | AllowAdult / Disallowed (no people or faces in the image) |
OutputConfig.InputComplianceCheck | No | String | Input compliance check: Enabled / Disabled |
OutputConfig.OutputComplianceCheck | No | String | Output compliance check: Enabled / Disabled |
OutputConfig.LogoAdd | No | String | Add a logo watermark: Enabled / Disabled |
InputRegion | No | String | Input region: Mainland (Chinese mainland) / Oversea (outside the Chinese mainland) / OverseaUSWest (US West) |
ExtInfo | No | String | JSON string carrying model-specific options; see Special settings |
SessionContext | No | String | Session identifier echoed back in the callback |
Request example โ
{
"SubAppId": 123456789,
"ModelName": "OG",
"ModelVersion": "image2_medium",
"Prompt": "a serene japanese garden, soft morning light",
"OutputConfig": {
"StorageMode": "Permanent",
"Resolution": "1K",
"AspectRatio": "9:16"
},
"SessionContext": "job-001"
}Response example โ
{
"AigcImageTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1024,
"Height": 1024,
"Container": "png"
}
}
]
}
}
}Special settings โ
Everything below works identically across the 2.0 / 2.5 / 2.6 series (the 2.6-only GIF / SVG output is covered in the 2.6 document).
Passing reference images โ
Each FileInfos entry declares its source with Type:
Type | Companion field | Description |
|---|---|---|
File | FileId | VOD media file ID |
Url | Url | Publicly accessible image URL |
Base64 | Base64 | Base64-encoded image |
Base64 limits
- The total size of all files must not exceed
7 MB, so the Base64-encoded request stays under the10 MBCloud API body limit; - Images must be
jpeg/jpg/png/webp; - Do not include a prefix such as
data:image/jpeg;base64,.
Multiple reference images โ
A single request accepts multiple reference images, up to 16. Use it for image editing, style transfer, and multi-image fusion (background swaps, element composition, and so on).
{
"SubAppId": 123456789,
"ModelName": "OG",
"ModelVersion": "image2_medium",
"FileInfos": [
{ "Type": "Url", "Url": "https://<cos>/room.png" },
{ "Type": "Url", "Url": "https://<cos>/fabric.jpg" }
],
"Prompt": "redesign this room with the material palette of the second image, keep the layout unchanged",
"OutputConfig": {
"StorageMode": "Permanent",
"Resolution": "1K",
"AspectRatio": "9:16"
},
"SessionContext": "job-001"
}Multi-image output (OutputImageCount) โ
OutputConfig.OutputImageCount sets how many images one request generates. OG accepts 1โ8 (limits differ per engine; Kling accepts 1โ9).
{
"OutputConfig": {
"StorageMode": "Permanent",
"Resolution": "1K",
"AspectRatio": "9:16",
"OutputImageCount": 3
}
}Custom resolution (size) โ
Set the output resolution directly through size inside ExtInfo.
| Constraint | Value |
|---|---|
| Width and height | Both multiples of 16 |
| Longest edge | At most 3840px (that is, no larger than 4K) |
| Total pixels | 655,360 โ 8,294,400 |
{
"SubAppId": 123456789,
"ModelName": "OG",
"ModelVersion": "image2_medium",
"Prompt": "a serene japanese garden, soft morning light",
"OutputConfig": {
"StorageMode": "Permanent",
"Resolution": "1K",
"AspectRatio": "9:16"
},
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\": \\\"2000x1104\\\"}\"}",
"SessionContext": "job-001"
}Common presets are 1024x1024 (square), 1536x1024 (landscape), and 1024x1536 (portrait). 2K (2560x1440) and 4K (3840x2160) output is also available, though anything above 2560px is experimental.
auto mode โ
Set size to auto and the model decides the resolution from the input.
{
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\": \\\"auto\\\"}\"}"
}Do not pass auto for AspectRatio
When size is auto, AspectRatio still needs a concrete ratio โ it must not be auto as well.
Mask-based image editing โ
Include an image with ReferenceType=mask in FileInfos to mask the region you want edited. The mask and the source image each take one entry.
{
"SubAppId": 123456789,
"ModelName": "OG",
"ModelVersion": "image2_medium",
"FileInfos": [
{
"Type": "Url",
"Url": "https://<cos>/room-mask.png",
"ReferenceType": "mask"
},
{
"Type": "Url",
"Url": "https://<cos>/room.png"
}
],
"Prompt": "the same sunny indoor lounge with a pool, but with a flamingo standing in the pool",
"OutputConfig": {
"StorageMode": "Permanent",
"Resolution": "1K",
"AspectRatio": "9:16"
},
"SessionContext": "job-001"
}Transparent background โ
Set background to transparent inside ExtInfo to generate an image with a transparent background.
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"background\\\":\\\"transparent\\\"}\"}"VOD and MPS place this option differently
The same OG engine takes the transparent-background option in different places: VOD nests it in AdditionalParameters inside ExtInfo (the JSON string is double-encoded), whereas MPS takes AdditionalParameters at the top level.
Output format (OutputFormat) โ
OutputConfig.OutputFormat sets the output format. The model default applies when omitted.
{
"OutputConfig": {
"StorageMode": "Permanent",
"Resolution": "1K",
"OutputFormat": "png"
}
}| Value | Description |
|---|---|
jpeg | JPEG output |
png | PNG output |
Choose png when you need lossless output, or when post-processing touches the alpha channel or fine gradients; jpeg is better when file size matters more than fidelity. Transparent backgrounds require png.
Text rendering โ
Multilingual text rendering covers Chinese, English, Japanese, Korean, Arabic, and more. image2_high handles complex text and small type best.
Related documents โ
| Document | Description |
|---|---|
| GPT-Image overview | Version comparison and shared specifications |
| GPT-Image 2.6 | Latest series: five tiers each for sunburst / flare |
| GPT-Image 2.5 | Two variants, xhigh / max tiers, measured generation times |
| VOD quick start | Authentication, task submission, and result polling for the VOD API |