GPT 이미지 2 API 문서
GPT 이미지 2 API 문서
GPT Image 2 APIQuickstartAuthenticationPricing
Polling strategyCredits & modelsErrors & refunds
Guides

Credits & models

How credits are debited and refunded, plus the full list of supported models.

Credit formula

Credits are debited from your balance when the task is accepted, and refunded automatically if the provider fails the task.

The actual formula is the pricing profile in src/ai/pricing/rules.ts:

credits = Math.ceil(
  base
    * durationMultiplier
    * resolutionMultiplier
    * outputsMultiplier
    * audioMultiplier
    * customMultiplier
);

When you submit a task the credits are pre-debited. If the task ends in status: 2 (FAILED), credits are refunded atomically — you will see creditsRefunded: true in the task snapshot.

Pricing rules live in src/ai/pricing/rules.ts in the repo. Individual model costs depend on parameters such as resolution and duration — use the generation endpoint response creditsUsed as the authoritative number for any given call.

For the per-model credit table, see Pricing.

Image models

Model IDDisplay nameModesMax refsMax prompt
gpt-image-2GPT Image 2text → image, image → image420 000
nano-banana-2Nano Banana 2text → image, image → image1420 000
nano-banana-proNano Banana Pro (Gemini 3)text → image, image → image810 000
google/nano-bananaNano Bananatext → image, image → image105 000

Video models

Model IDDisplay nameModes
kling/v2-1-standardKling V2.1 Standardimage → video
kling/v2-1-proKling V2.1 Proimage → video
kling/v2-1-master-text-to-videoKling V2.1 Mastertext → video
sora-2-text-to-videoSora 2text → video
sora-2-pro-text-to-videoSora 2 Protext → video
sora-2-image-to-videoSora 2 Image-to-Videoimage → video
hailuo/02-text-to-video-standardHailuo Standardtext → video
hailuo/02-text-to-video-proHailuo Protext → video
hailuo/02-image-to-video-standardHailuo I2V Standardimage → video
hailuo/02-image-to-video-proHailuo I2V Proimage → video
veo3_fastVeo 3.1 Fasttext → video, image → video (up to 3 refs)
veo3Veo 3.1 Qualitytext → video, image → video (up to 2 refs)
veo3_liteVeo 3.1 Litetext → video, image → video (up to 2 refs)
wan/2-6-text-to-videoWan 2.6text → video
wan/2-6-image-to-videoWan 2.6 I2Vimage → video
bytedance/seedance-1.5-proSeedance 1.5 Protext → video, image → video

Topping up credits

  • Subscription plans grant a monthly credit allowance.
  • Daily free credits roll in automatically for active accounts.
  • One-time credit packages can be purchased from the dashboard billing page.

Subscriptions and packages both deposit into the same balance — there is no routing logic to think about from the caller side.

Polling strategy

How to poll GET /api/ai/tasks/{id} efficiently without rate-limiting yourself or our upstream providers.

Errors & refunds

HTTP status codes returned by the API, error shape, and the automatic refund contract.

목차

Credit formulaImage modelsVideo modelsTopping up credits