sora_generate_video_async
Generate AI videos asynchronously via webhook callbacks. Submit requests and receive automatic notifications when complete, avoiding blocking waits for long-running video generation.
Instructions
Generate an AI video asynchronously with callback notification.
This is useful for long-running video generation tasks. Instead of waiting
for the video to complete, you'll receive a callback at your specified URL
when the generation is finished.
Use this when:
- You don't want to wait for the generation to complete
- You have a webhook endpoint to receive results
- You're integrating with an async workflow
The callback will receive a POST request with the same response format
as the synchronous generation tools.
Returns:
Task ID that you can use to correlate with the callback.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Description of the video to generate. | |
| callback_url | Yes | URL to receive the callback when video generation is complete. The result will be POSTed to this URL as JSON. | |
| model | No | Sora model version. | sora-2 |
| size | No | Video resolution. | large |
| duration | No | Video duration in seconds. | |
| orientation | No | Video orientation. | landscape |
| image_urls | No | Optional list of reference image URLs for image-to-video generation. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |