# Image AI Edit Options

### Model

The API offers two models. We recommend `v2` for most production use cases due to its superior quality and speed.

<table><thead><tr><th width="112.3333740234375">Model</th><th>Description</th></tr></thead><tbody><tr><td><code>v2</code></td><td><strong>Recommended</strong>. Our latest model: native 2K resolution, faster, more accurate prompt following, better texture realism and product preservation.</td></tr><tr><td><code>v1</code></td><td>Older model retained for workflows requiring custom aspect ratio.</td></tr></tbody></table>

`v2` model is used by default.

```json
"options": {
  "model": "v2",
  "prompt": "add a duck"
}
```

### Prompt <a href="#upscale" id="upscale"></a>

The prompt is a text description that guides the AI on how to edit the image. It tells the AI what new elements to add or what changes to make.

```json
"options": {
  "prompt": "add a duck"
}
```

### Inference Steps

{% hint style="warning" %}
The choice of inference steps is only supported for the `v1` model.
{% endhint %}

Inference steps controls the number of steps the AI takes to refine the image. A higher number of steps can produce more detailed and higher-quality images but will also increase the processing time.

<pre class="language-json"><code class="lang-json">"options": {
<strong>  "model": "v1",
</strong>  "prompt": "add a duck",
  "inference_steps": 50
}
</code></pre>

### Guidance Scale

{% hint style="warning" %}
The choice of guidance scale is only supported for the `v1` model.
{% endhint %}

The guidance scale determines how closely the AI should follow the instructions in your prompt. A higher value means the AI will stick more strictly to your prompt, while a lower value allows the AI to be more creative and generate a more diverse result.

```json
"options": {
  "model": "v1",
  "prompt": "add a duck",
  "guidance_scale": 4.0
}
```

### Aspect Ratio

{% hint style="warning" %}
The choice of aspect ratio is only supported for the `v1` model.
{% endhint %}

The aspect ratio defines the final dimensions of the edited image. This parameter is used to crop and resize the output to a specific width-to-height ratio. The API supports various common aspect ratios.

```json
"options": {
  "model": "v1",
  "prompt": "add a duck",
  "aspect_ratio": "1:1"
}
```

By default, the aspect ratio is the same as an input image. But you can change it to any of the following values:

| Aspect ratio | Output size |
| ------------ | ----------- |
| 1:1          | 1024x1024px |
| 2:3          | 832x1248px  |
| 3:2          | 1248x832px  |
| 3:4          | 880x1168px  |
| 4:3          | 1168x880px  |
| 9:16         | 768x1360px  |
| 16:9         | 1360x768px  |
| 9:21         | 656x1552px  |
| 21:9         | 1552x656px  |

### Possible values

| Parameter         | Type    | Range           | Default value      |
| ----------------- | ------- | --------------- | ------------------ |
| `model`           | string  | `"v1"` , `"v2"` | `"v2"`             |
| `prompt`          | string  | 3-5000          | **required**       |
| `inference_steps` | integer | 1-50            | depends on a model |
| `guidance_scale`  | float   | 1.0-10.0        | depends on a model |
| `aspect_ratio`    | string  | "1:1".."21:9"   | same as input      |