Generations

Price a generation

Same body as POST /api/v2/generations. Runs the same checks, answering the same 400 errors, and returns the credit cost, your balance and whether it covers the cost, without starting anything or charging. Input images and videos are optional here, so a request can be priced before its files are uploaded.

post/api/v2/generations/estimate

Request

  • Base URL: https://azurade.com
  • URL: https://azurade.com/api/v2/generations/estimate
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization

Request body

aspect_ratiostring

Output aspect ratio

audiostring

URL of an audio file (voice or music) the video syncs to

audio_settingstring

Video editing: auto generates new audio, origin keeps the input video's audio

backgroundstring

Whether the background is transparent or opaque

callback_urlstring uri

Optional https URL, up to 2048 characters. When the job is final, completed with its outputs or failed or canceled with its error, it is POSTed there once, as JSON: the body GET /api/v2/generations/{id} answers. A network error, a 5xx or a 429 is retried for about six minutes; any other answer ends it. Nothing signs the request, so read the job back with GET before trusting what it says

camera_fixedboolean

Keep the camera position fixed

character_orientationstring

Character orientation source for motion control

durationinteger

Video duration in seconds

enable_sequentialboolean

Batch mode: generate a set of related images (up to 12)

enhance_promptboolean

Rewrite the prompt in more detail before generating, with the model's prompting guide or its own built-in rewriter (GET /api/v2/models/{id} says which); free, included in the generation price

first_clip_urlstring

URL of a video clip to continue (image-to-video mode); use instead of image and last_image

fpsinteger

Frames per second

generate_audioboolean

Generate a soundtrack for the video

go_fastboolean

Use faster generation mode

google_searchboolean

Enable Google Search grounding for image generation

guidancenumber

Guidance scale (CFG scale)

guidance_scalenumber

Guidance scale (CFG scale)

heightinteger

Output height in pixels

high_performanceboolean

Use high performance mode (better quality)

idempotency_keystring

Any string you choose, up to 255 characters. A create repeated with the same key (after a timeout, say) returns the first job, marked idempotent_replay: true, instead of starting and charging a second; while the first is still being submitted the repeat answers 409 idempotency_in_progress. A different request under a used key answers 422 idempotency_key_reused, so use a new key for a new request

imagestring

Input image URL: the image to edit, animate or work on

image_inputstring[]

Multiple image URLs for editing or reference

infer_stepsinteger

Number of denoising steps

input_imagestring

Input image URL

is_proboolean

Use Pro variant

last_imagestring

URL of the image the video ends on; pair with image, which it starts on

lora_scalenumber

LoRA scale factor

lora_scale_transformernumber

How strongly the transformer LoRA is applied

lora_scale_transformer_2number

How strongly the second transformer LoRA is applied

lora_weightsstring

LoRA weights URL or identifier

lora_weights_transformerstring

URL of LoRA weights (.safetensors) for the transformer

lora_weights_transformer_2string

URL of a second set of LoRA weights (.safetensors) for the transformer

max_imagesinteger

Most images to make; state the same number in the prompt. The model may make fewer, and images not delivered are refunded

megapixelsstring

Approximate output size in megapixels

model'flux-dev' | 'flux-kontext-pro' | 'gpt-image-2' | 'gpt-image-2.5' | 'hunyuan' | 'imagen-4-ultra' | 'kling-3.0' | 'kling-3.0-turbo' | 'motion-control' | 'nano-banana' | 'nano-banana-2' | 'nano-banana-2-lite' | 'nano-banana-2.1' | 'nano-banana-pro' | 'qwen-image' | 'qwen-image-2.1' | 'qwen-image-edit' | 'qwen-image-edit-plus' | 'qwen-image-edit-plus-lora' | 'qwen-image-layered' | 'recraft-crisp-upscale' | 'remove-background' | 'restore-image' | 'seedance-2' | 'seedance-2-mini' | 'seedance-2.5' | 'seedance-pro' | 'seedream-3' | 'seedream-4' | 'seedream-4.5' | 'seedream-5-flash' | 'seedream-5-lite' | 'seedream-5-pro' | 'veo2' | 'veo3' | 'veo3-fast' | 'veo3.1' | 'vidu-q4' | 'vidu-q4-reference' | 'wan-2.2' | 'wan-2.6' | 'wan-2.7' | 'wan-2.7-image' | 'wan-3.0' | 'wan-3.0-prime' required

Model id from GET /api/v2/models

ninteger

Number of images, billed per image: 1-4, or 1-12 with enable_sequential. 1 when omitted. Images not delivered are refunded

negative_promptstring

Negative prompt to avoid certain content

num_framesinteger

Clip length in frames: the clip lasts num_frames / fps seconds. 121 when omitted (5 s at 24 fps), or 81 with high_performance (3.4 s)

num_inference_stepsinteger

Number of denoising steps

num_layersinteger

Number of layers to split the image into, 2 to 8 (billed per layer)

num_outputsinteger

Number of images to generate, billed per image; images not delivered are refunded

optimize_promptboolean

The model's own option: it translates the prompt to Chinese before generating. Independent of translate_prompt, which translates the prompt to English before the model gets it; one of the two is enough for a prompt in another language

output_formatstring

Output image format

output_qualityinteger

Output quality (1-100)

promptstring

The prompt to generate from

prompt_extendboolean

Let the model expand the prompt before generating

prompt_strengthnumber

Strength of prompt influence for image-to-image

qualitystring

Quality level: basic (2K) or high (4K)

reference_audiosstring[]

Audio URLs that steer the soundtrack (3 to 5 at most, by model); ignored when image or last_image is set

resolutionstring

Output resolution

sample_shiftnumber

Shifts the denoising schedule: higher values favour overall composition and motion, lower values fine detail

seedinteger

Random seed for reproducibility; 0 or omitted picks one at random

sizestring

Output size preset

thinking_modeboolean

Reason about the prompt before generating; text-to-image without enable_sequential only

translate_promptboolean

Translate the prompt to English before generating; free, included in the generation price

veo31_generation_typestring

How the images in veo31_image_urls are used. Leave it out and the count decides: no images is TEXT_2_VIDEO, one or two are the first and last frames (FIRST_AND_LAST_FRAMES_2_VIDEO), three are reference images (REFERENCE_2_VIDEO, which takes veo3_fast and 16:9 only)

veo31_image_urlsstring[]

1 to 3 image URLs: one image is the first frame, two are the first and last frames, three are reference images for the subject and style

veo31_modelstring

Quality tier: veo3 renders at higher quality, veo3_fast renders faster and costs less

veo31_watermarkstring

Watermark text to put on the video

video_inputstring[]

Multiple video URLs for video-to-video generation

video_lengthinteger

Clip length in frames: the clip lasts video_length / fps seconds, 129 frames at 24 fps (5.4 s) by default

watermarkboolean

Add a watermark to the output

web_searchboolean

Let the model look up the prompt's subject on the web; text-to-video only

widthinteger

Output width in pixels

Response

OK

affordableboolean

Whether balance covers cost

balancenumber

Your credits now

costnumber
modelstring
shortfallnumber

Credits missing to cover cost; 0 when affordable

type'image' | 'video'
variantstring

Changes

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