platform-api

Price an image before creating it: USD per image and the balance hold; writes nothing

post/v1/images/estimate

Request

  • Base URL: https://api.cuddler.ai
  • URL: https://api.cuddler.ai/v1/images/estimate
  • Auth: HTTP bearer

Request body

model'seedream-5' | 'seedream-5-pro' | 'qwen-image-3' | 'z-image-turbo' | 'grok-imagine-2.0' | 'ideogram-4' | 'ideogram-4.5' | 'recraft-4.1' | 'nano-banana-2.1' | 'nano-banana-2' | 'nano-banana-2-lite' | 'nano-banana-pro' | 'imagen-4-ultra' | 'imagen-4' | 'imagen-4-fast' | 'imagen-3' | 'imagen-3-fast' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2' | 'gpt-image-1.5' | 'gpt-image-1-mini' | 'gpt-image-1' required
reference_image_countinteger
variant'default' | 'fast' | 'pro' | 'standard' | 'turbo' | '4k' | 'base' | 'utility' | 'utility-pro'
resolution'0.5K' | '1K' | '2K' | '4K'
aspect_ratio'1:1' | '4:3' | '3:4' | '16:9' | '9:16'

Response

What POST /v1/images would bill and hold

object'image_estimate' required
model'seedream-5' | 'seedream-5-pro' | 'qwen-image-3' | 'z-image-turbo' | 'grok-imagine-2.0' | 'ideogram-4' | 'ideogram-4.5' | 'recraft-4.1' | 'nano-banana-2.1' | 'nano-banana-2' | 'nano-banana-2-lite' | 'nano-banana-pro' | 'imagen-4-ultra' | 'imagen-4' | 'imagen-4-fast' | 'imagen-3' | 'imagen-3-fast' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2' | 'gpt-image-1.5' | 'gpt-image-1-mini' | 'gpt-image-1' required
resolution'0.5K' | '1K' | '2K' | '4K' required
aspect_ratio'1:1' | '4:3' | '3:4' | '16:9' | '9:16' required
imagesinteger required
usdstring required
usd_microsinteger required
hold_usdstring required
usd_per_imagestring required
price_versionstring required
list_usdstring
unit'image' required

Changes

No recorded changes to this operation across all 1 revision of this API.