# Image to Video Options

### Prompt

The Image to Video API accepts text prompts to define the result. Prompts can be generated automatically using Autoprompt AI or provided manually.

**Autoprompt AI: Automatic prompt generation**

Autoprompt AI analyzes the input product image and generates a text prompt tailored to create a contextually relevant video. This is useful for automating image to video generation, especially with large batches of images.

**How to use it:** Set the `generate` parameter to `true` within the `prompt` object in the `options` section of your API request.

```json
{
    "options": {
        "prompt": {
            "generate": true
        }
    }
}
```

You can influence Autoprompt AI by providing guidelines:

```json
{
    "options": {
        "prompt": {
            "generate": true,
            "guidelines": "zoom out, glitter particles"
        }
    }
}
```

**Custom prompts: Manual control**

For even more precise control over the animation and visual elements, provide your own prompt. Custom prompts must be between 3 and 5000 characters.

**Example:**

{% code overflow="wrap" %}

```json
{
    "options": {
        "prompt": "The camera slowly rotates left to right around the burger with natural and realistic motion. Steam rises gently from the top, drifting upward. Bacon edges shift slightly from the heat. Melted cheese softens and begins to drip slowly. A thick drop of sauce slides down the side. The grilled patty glistens as it turns, showing juicy texture. Lettuce and tomato stay fresh and still. The bun gives off a soft heat shimmer. As the camera moves, the full burger looks hot, fresh, and ready to eat. The background shifts gently with it, keeping the burger centered. Soft, out-of-focus lighting moves across the backdrop, creating a rich, appetizing atmosphere."
    }
}
```

{% endcode %}

### Negative prompt

The negative prompt is a parameter that specifies what you don't want to see on the generated video. When specified, it tells the generation process not to include things in the video that match a given text. The `negative_prompt` must be between 3 and 5000 characters.

```json
{
    "options": {
        "prompt": {"generate": true},
        "negative_prompt": "blur, distort, and low quality"
    }
}
```

### Duration

The duration parameter controls how long the generated video will be. It can be set to 5 seconds or 10 seconds.

```json
{
    "options": {
        "prompt": {"generate": true},
        "duration": 5
    }
}
```

### Guidance scale

The guidance scale controls how closely the generated video should match your prompt. You may adjust this scale to gain more control over the output.

Note that adjusting this scale may affect quality.

```json
{
    "options": {
        "prompt": {"generate": true},
        "guidance_scale": 0.5
    }
}
```

### Possible values

<table><thead><tr><th width="244">Parameter</th><th>Type</th><th>Range</th><th>Default value</th></tr></thead><tbody><tr><td><mark style="color:purple;"><code>prompt</code></mark></td><td>string or object</td><td>3 - 5000</td><td><strong>is required</strong></td></tr><tr><td><mark style="color:purple;"><code>negative_prompt</code></mark></td><td>string</td><td>3 - 5000</td><td></td></tr><tr><td><mark style="color:purple;"><code>duration</code></mark></td><td>integer</td><td><code>5</code>, <code>10</code></td><td>5</td></tr><tr><td><mark style="color:purple;"><code>guidance_scale</code></mark></td><td>float</td><td>0.0 - 1.0</td><td>0.5</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.claid.ai/image-to-video-api/image-to-video-options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.