> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI video generation example

> OpenAI async video-generation example.

## Recommended endpoints

* [OpenAI /v1/videos](/en/api-reference/endpoints/openai/video)
* [OpenAI /v1/videos/{video_id}](/en/api-reference/endpoints/openai/video-status)
* [OpenAI /v1/videos/{video_id}/content](/en/api-reference/endpoints/openai/video-content)

## Minimal request

```json theme={null}
{
  "model": "sora-2",
  "prompt": "An 8-second ApiGo product demo animation",
  "seconds": 8,
  "size": "1280x720"
}
```

## cURL example

```bash theme={null}
curl https://maas.apigo.ai/v1/videos \
  -H "Authorization: Bearer $YOUR API KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "An 8-second ApiGo product demo animation",
    "seconds": 8,
    "size": "1280x720"
  }'
```

## Python example

```python theme={null}
import requests

response = requests.post(
    "https://maas.apigo.ai/v1/videos",
    headers={
        "Authorization": "Bearer <YOUR API KEY>",
        "Content-Type": "application/json",
    },
    json={
        "model": "sora-2",
        "prompt": "An 8-second ApiGo product demo animation",
        "seconds": 8,
        "size": "1280x720",
    },
)

print(response.json())
```

## Node.js example

```js theme={null}
const response = await fetch("https://maas.apigo.ai/v1/videos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.YOUR API KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "sora-2",
    prompt: "An 8-second ApiGo product demo animation",
    seconds: 8,
    size: "1280x720",
  }),
});

console.log(await response.json());
```

## Best practices

* Treat create, status, and content retrieval as separate steps
* Poll at a reasonable interval with backoff
* Proxy large downloads or temporary URLs through the backend