Skip to content

GPT-image โ€‹

Updated

Request domain (international site): tokenhub-intl.tencentcloudmaas.com (Singapore) Endpoints: POST /v1/wand/og-image/generation (text-to-image), POST /v1/wand/og-image/edits (image editing)

GPT-image is a family of image generation models invoked synchronously through the TokenHub path, supporting both text-to-image and image editing. The result is already contained in the response body when the request returns โ€” no task polling required. Three versions are available โ€” 2.0, 2.5, and 2.6 โ€” all sharing the same endpoints and authentication, differing only in the model value.

All Three Versions Require Allowlisting

This family consists of test models and requires an allowlist entry granted by the backend team before it can be used. Contact the product team and submit your UIN and AppId. Allowlisting takes effect per model ID, so -f and -s must be requested separately; GIF output on 2.6 additionally requires the model's GIF preview entitlement.

TokenHub settles on an hourly cycle. Sales should apply for customer discounts in good time.

Choose a Version โ€‹

The API reference is split per version. Click a card to see that version's model IDs, input parameters, request examples, and version-specific settings.

Version Comparison โ€‹

Item2.02.52.6
Model IDcustom-model-og-v2custom-model-og-v2.5-f
custom-model-og-v2.5-s
custom-model-og-v2.6-f
custom-model-og-v2.6-s
Variant positioningSingle variantFlare for speed / Sunburst for precisionFlare for speed / Sunburst for detail
Quality tiers qualityauto / low / medium / highPlus xhigh / maxPlus xhigh / max
Planning tier complexityโŒโŒโœ… Three tiers, default high
Output formatspng / jpegpng / jpegPlus webp / gif / svg
mask inpaintingโœ…โœ…โœ…
markup annotation editingโŒโœ…โœ…
Animated GIFโŒโŒโœ… Text-to-image endpoint only
SVG vectorโŒโŒโœ… Text-to-image endpoint only
Generation speedBaselineBaselineAbout 50% faster

Selection Advice โ€‹

  • Prefer 2.6 for new integrations: at high and above it costs the same as 2.5 but runs about 50% faster, so upgrading carries no cost penalty.
  • Stay on 2.5 if low-quality batch generation dominates: output image token counts at 2.6's low / medium tiers rise to roughly 4.2ร— / 3.3ร—, so per-image cost increases noticeably for icons, thumbnails, and bulk drafts.
  • GIF and SVG require 2.6, and both outputs are supported only on the text-to-image endpoint.
  • For local edits only, pairing 2.6 with complexity=low skips re-laying-out the scene.

The Token Unit Price Is Identical Across All Three Versions

All are 1.6 USD per million tokens. Cost differences between versions come from the number of output image tokens, not the unit price. See "Billing and Pricing" in each version's document for the full conversion table.

DocumentDescription
GPT-image 2.6Latest version: ~50% faster, complexity decoupled, GIF and SVG
GPT-image 2.5Two variants, xhigh / max tiers, markup-based editing
GPT-image 2.0Base version, with quality tiers up to high
Get an API KeyApplying for and managing TokenHub API Keys

Built with VitePress ยท Deployed on Tencent EdgeOne Pages