API Evangelist conversational phrasing for OpenAI Videos API

# 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'