Separate the model profile from the selectable output geometry
The critical question is whether the deliverable requires a documented API control, not which model has the more appealing description. Claid describes v2 as its recommended default, with native 2K resolution and improved processing characteristics. That describes the v2 model profile; it does not make the v1 aspect-ratio table a set of v2 output-size guarantees.
The official Image AI Edit options page restricts explicit aspect_ratio, inference_steps and guidance_scale selection to v1. The supported v1 ratios are 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 9:21 and 21:9. The table associates 2:3 with 832×1248 pixels, for example.
The listed options do not include 4:5. If the destination requires exactly 4:5, do not silently substitute 3:4 or imply that a custom value is supported. Resolve the delivery specification through an appropriate separate workflow.
Reject configurations that mix incompatible model requirements
Define mandatory requirements before assembling the options object. A seller may prefer v2's native-resolution profile but also request a custom ratio and guidance tuning. The supplied documentation does not provide one model configuration that satisfies those requirements simultaneously.
If the selected ratio and guidance control are mandatory, choose v1 and use documented values. Its inference_steps range is 1–50, and guidance_scale ranges from 1.0–10.0. If v2 is mandatory, remove the v1-only controls and plan any separate framing work explicitly. Do not assume unsupported fields are automatically ignored or translated.
Claid's documented aspect_ratio operation crops and resizes to a width-to-height proportion. It is not a promise of unchanged subject placement, exact lettering or source-pixel preservation.
{
"options": {
"model": "v1",
"prompt": "Place the supplied ceramic tray on a neutral studio background",
"aspect_ratio": "2:3",
"guidance_scale": 4.0
}
}Record which requirement caused the model change
Keep a compact specification containing the intended placement, selected model, supported request fields and expected output geometry. Label the example JSON as an options fragment rather than a complete API request.
After any authorized submission, compare the actual returned dimensions with the planned format and independently inspect the product. If the output has the correct ratio but inaccurate product details, the problem is not solved by another aspect_ratio value.
If the intended placement has no supported v1 ratio, record that constraint before production instead of calling a nearby proportion equivalent.
Illustrative decision: a 2:3 portrait product creative
A seller has a landscape photograph of a ceramic tray and needs a portrait image for a campaign placement specified as 2:3. The brief also requires an explicit guidance_scale of 4.0. Both requirements point to v1. The seller prepares the documented 2:3 ratio, whose listed v1 output size is 832×1248 pixels.
If the campaign owner instead prioritizes v2's native 2K model profile and permits separate layout preparation, the next action changes: select v2 without aspect_ratio or guidance_scale and handle destination framing independently.
If the destination later changes to an exact 4:5 requirement, neither the 2:3 example nor an undocumented 4:5 value is an acceptable substitute. The delivery specification must be resolved before release.
Where CartVisual fits
Relevant as a separate source-led product-image editing workflow. It neither executes Claid Image AI Edit nor exposes the documented v1 and v2 parameter contract.
Source and evidence scope
Prepared by the CartVisual editorial team with AI assistance. Competitor behavior is documented rather than independently executed for this guide.
Official source snapshot checked .
The Claid Image AI Edit Options documentation establishes model defaults, v1-only controls, supported aspect ratios, output-size examples and parameter ranges. It does not establish exact crop fidelity, undocumented v2 geometry overrides or a 4:5 option. Delivery-priority decisions are editorial guidance.