# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dolby OptiView Ad Engine Image API
  version: 1.0.0
extends: openapi/dolby-image-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 1
- target: $.paths['/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Grab a still frame from a cloud video
      effect: read
      questions:
      - Can I extract a thumbnail image from a video stored in the cloud?
      - How do I pick the frame position and output format for a still?
      instructions:
      - text: Grab a still from {url} using auth token {auth_token}.
        slots:
          url: query.url
          auth_token: header.x-rasp-auth-token
      - text: Capture a {format} frame from {url} at {offset_percent} percent, sized {width}x{height}, token {auth_token}.
        slots:
          format: query.format
          url: query.url
          offset_percent: query.offset_percent
          width: query.width
          height: query.height
          auth_token: header.x-rasp-auth-token
      method: generated
      generated: '2026-10-01'