CartVisualCreate account

When does a required output ratio force Claid Image AI Edit from its default v2 model to v1?

Claid recommends Image AI Edit v2 and selects it by default, but explicit aspect_ratio, inference_steps and guidance_scale controls belong to v1. Choose v1 when one of these controls is a mandatory request requirement. Choose v2 when its documented model profile matters more and those controls are unnecessary. A requested ratio does not establish exact product fidelity.

Published · By CartVisual editorial team

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.

See the current CartVisual workflow and its limitations

Source and evidence scope

Prepared by the CartVisual editorial team with AI assistance. Competitor behavior is documented rather than independently executed for this guide.

Claid: Image AI Edit Options

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.

Related decisions

Browse ecommerce creative workflows