# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for OpenAI Videos API version: 1.0.0 extends: openapi/openai-videos-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 10 - target: $.paths['/videos'].get update: x-apievangelist-phrasing: intent: List recently generated videos effect: read questions: - Which videos have I generated recently in this project? - Can I list my generated videos oldest first? instructions: - text: List my recently generated videos. - text: Show {limit} generated videos ordered {order}. slots: limit: query.limit order: query.order method: generated generated: '2026-09-26' - target: $.paths['/videos'].post update: x-apievangelist-phrasing: intent: Generate a new video from a prompt effect: write questions: - How do I generate a video from a text prompt? - Can I set the length and resolution of a generated video? - Is it possible to guide a new video with a reference image? instructions: - text: Generate a video of {prompt}. slots: prompt: requestBody.prompt - text: Make a {seconds}-second {size} video of {prompt}. slots: seconds: requestBody.seconds size: requestBody.size prompt: requestBody.prompt - text: Generate a video with {model} from the prompt {prompt} using reference {input_reference}. slots: model: requestBody.model prompt: requestBody.prompt input_reference: requestBody.input_reference method: generated generated: '2026-09-26' - target: $.paths['/videos/characters'].post update: x-apievangelist-phrasing: intent: Create a reusable character from a video effect: write questions: - Can I turn someone in an uploaded video into a character I can reuse? - What do I need to provide to create a video character? instructions: - text: Create a character named {name} from video {video}. slots: name: requestBody.name video: requestBody.video - text: Save the person in {video} as a reusable character called {name}. slots: video: requestBody.video name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/videos/characters/{character_id}'].get update: x-apievangelist-phrasing: intent: Get a saved video character effect: read questions: - What details are stored for a video character I created? - Can I fetch a character by its ID? instructions: - text: Show video character {character_id}. slots: character_id: path.character_id - text: Fetch the details of character {character_id}. slots: character_id: path.character_id method: generated generated: '2026-09-26' - target: $.paths['/videos/edits'].post update: x-apievangelist-phrasing: intent: Edit a video with a prompt effect: write questions: - How do I change something in an existing video using a prompt? - Can I edit a video I uploaded, not just one I generated? instructions: - text: Edit video {video} so that {prompt}. slots: video: requestBody.video prompt: requestBody.prompt - text: Apply the edit {prompt} to source video {video}. slots: prompt: requestBody.prompt video: requestBody.video method: generated generated: '2026-09-26' - target: $.paths['/videos/extensions'].post update: x-apievangelist-phrasing: intent: Extend a completed video effect: write questions: - Can I make a finished video longer by continuing it? - How many extra seconds can I add when extending a video? instructions: - text: Extend video {video} by {seconds} seconds with {prompt}. slots: video: requestBody.video seconds: requestBody.seconds prompt: requestBody.prompt - text: Continue {video} for another {seconds} seconds showing {prompt}. slots: video: requestBody.video seconds: requestBody.seconds prompt: requestBody.prompt method: generated generated: '2026-09-26' - target: $.paths['/videos/{video_id}'].get update: x-apievangelist-phrasing: intent: Check a video generation job's status effect: read questions: - Is my video still rendering or has it completed? - What is the latest metadata for a video I generated? instructions: - text: Show video {video_id}. slots: video_id: path.video_id - text: Check whether video {video_id} has finished rendering. slots: video_id: path.video_id method: generated generated: '2026-09-26' - target: $.paths['/videos/{video_id}'].delete update: x-apievangelist-phrasing: intent: Delete a video and its stored assets effect: destructive questions: - How do I permanently delete a generated video? - Can I delete a video generation that failed? instructions: - text: Delete video {video_id}. slots: video_id: path.video_id - text: Permanently remove video {video_id} and its stored assets. slots: video_id: path.video_id method: generated generated: '2026-09-26' - target: $.paths['/videos/{video_id}/content'].get update: x-apievangelist-phrasing: intent: Download a generated video file effect: read questions: - How do I download the finished video file? - Can I get a thumbnail or preview instead of the full video? instructions: - text: Download the rendered video {video_id}. slots: video_id: path.video_id - text: Download the {variant} for video {video_id}. slots: variant: query.variant video_id: path.video_id method: generated generated: '2026-09-26' - target: $.paths['/videos/{video_id}/remix'].post update: x-apievangelist-phrasing: intent: Remix a completed video with a new prompt effect: write questions: - Can I remix a video I already generated with a different prompt? - What's the way to rework a finished video with a refreshed prompt? instructions: - text: Remix video {video_id} with the prompt {prompt}. slots: video_id: path.video_id prompt: requestBody.prompt - text: Make a remix of {video_id} where {prompt}. slots: video_id: path.video_id prompt: requestBody.prompt method: generated generated: '2026-09-26'