# Sora 2 Pro

## openai/sora-2-pro-image-to-video

> Image-to-video endpoint for Sora 2 Pro, OpenAI's state-of-the-art video model capable of creating richly detailed, dynamic clips with audio from natural language or images.

```json
{"openapi":"3.1.0","info":{"title":"API Reference","version":"1.0.0"},"tags":[{"name":"sora-2-pro"}],"servers":[{"url":"https://video.onerouter.pro","description":"video"}],"security":[],"paths":{"/v1/videos/generations":{"post":{"summary":"openai/sora-2-pro-image-to-video","deprecated":false,"description":"Image-to-video endpoint for Sora 2 Pro, OpenAI's state-of-the-art video model capable of creating richly detailed, dynamic clips with audio from natural language or images.","tags":["sora-2-pro"],"parameters":[{"name":"Authorization","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"model is the model name"},"prompt":{"type":"string","description":"The text prompt describing the video you want to generate"},"resolution":{"type":"string","description":"The resolution of the generated video Default value: `\"auto\"`\n\nPossible enum values: `auto`, `720p`, `1080p`","enum":["720p","1080p","auto"],"default":"auto"},"aspect_ratio":{"type":"string","description":"The aspect ratio of the generated video Default value: `\"auto\"`\n\nPossible enum values: `auto`, `9:16`, `16:9`","enum":["16:9","9:16","auto"],"default":"auto"},"duration":{"type":"string","description":"Duration of the generated video in seconds Default value: `\"4\"`\n\nPossible enum values: `4`, `8`, `12`","enum":["4","8","12"],"default":"4"},"image_url":{"type":"string","description":"The URL of the image to use as the first frame"},"output_format":{"type":"string","description":"output_format indicate the output format, default value is `url`.","enum":["url"],"default":"url"}},"required":["model","prompt","image_url"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"revised_prompt":{"type":"string"},"video_id":{"type":"string"}}}},"created":{"type":"integer"}},"required":["data","created"]}}},"headers":{}}}}}}}
```


---

# 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://infronai.gitbook.io/docs/media-apis/image-to-video-api/sora-2-pro.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.