model, on v1 generation, try-on, editing, inpaint, and video requests. API version v1 and try-on model v1 are separate concepts.
V6 is available to all Studio API accounts with the required plan and credits. Older V4, V4x, and V5 access can still be restricted. An explicit model choice must support the requested operation and settings.
Generate supports up to three garment references. V6 try-on supports up to four items; other try-on models may support fewer. Choose one outfit source array per request. Generate and try-on allow up to eight outputs where account limits permit; edit and inpaint create one.
Image quality
resolution defaults to standard; choose high for higher quality. Dimensions depend on the model and proportions. Read dimensions from the result.
For Nano Banana 2 or Pro generation, common aspect ratios include 1:1, 3:4, 4:5, 2:3, 9:16, 16:9, 4:3, 3:2, 5:4, and 21:9. Other models can accept different ratios.
Video inputs
Start with a single five-second shot.kling-2.5 supports five seconds in this API. Kling 3 supports single clips of 3–15 seconds and optional generate_audio.
For multiple shots, send multi_prompt and omit the top-level prompt and duration. Each shot requires a nonblank prompt and a duration of 3–15 seconds. The sum must not exceed 15 seconds; that sum determines the clip duration and cost. End frames require a single shot.
Kling 3 subjects use elements: [{"asset_id": "ASSET_ID"}]. Each asset must be an accessible model or outfit with a valid display_image URL. Upload a reference to the asset before using it. Model assets are placed before outfit assets in element numbering. Direct subject image IDs and URLs are not accepted by v1 video requests.
Start and end frames must each be at least 300 × 300 pixels, no larger than 10 MiB, and have a width-to-height ratio between 0.4 and 2.5. When supplying an end frame, its dimensions must match the start frame. Choose last_frame_id or last_frame_url.
Read validation errors before changing models or settings. Higher quality, more outputs, or another model can change credit use. Current commercial terms are available in pricing.