API Evangelist conversational phrasing for OpenAI Usage 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 Usage API
  version: 1.0.0
extends: openapi/openai-usage-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: 9
- target: $.paths['/organization/costs'].get
  update:
    x-apievangelist-phrasing:
      intent: Report the organization's spend over time
      effect: read
      questions:
      - How much has my organization spent on the API since the start of the month?
      - Can I break my costs down by project or line item?
      - What did one specific project cost us each day last week?
      instructions:
      - text: Show our API costs since {start_time}.
        slots:
          start_time: query.start_time
      - text: Break down costs from {start_time} to {end_time} grouped by {group_by}.
        slots:
          start_time: query.start_time
          end_time: query.end_time
          group_by: query.group_by
      - text: Show spend for projects {project_ids} since {start_time}.
        slots:
          project_ids: query.project_ids
          start_time: query.start_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/audio_speeches'].get
  update:
    x-apievangelist-phrasing:
      intent: Report text-to-speech usage
      effect: read
      questions:
      - How many characters of text-to-speech did we generate this month?
      - Which models are driving our speech generation usage?
      instructions:
      - text: Show text-to-speech usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Break down audio speech usage since {start_time} by {group_by}.
        slots:
          start_time: query.start_time
          group_by: query.group_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/audio_transcriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: Report speech-to-text transcription usage
      effect: read
      questions:
      - How many seconds of audio have we transcribed recently?
      - Can I see transcription usage for just one API key?
      instructions:
      - text: Show audio transcription usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Show transcription usage for API keys {api_key_ids} since {start_time}.
        slots:
          api_key_ids: query.api_key_ids
          start_time: query.start_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/code_interpreter_sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: Report code interpreter session usage
      effect: read
      questions:
      - How many code interpreter sessions has our organization opened?
      - Which projects are using the most code interpreter sessions?
      instructions:
      - text: Show code interpreter session counts since {start_time}.
        slots:
          start_time: query.start_time
      - text: Count code interpreter sessions for projects {project_ids} since {start_time}.
        slots:
          project_ids: query.project_ids
          start_time: query.start_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/completions'].get
  update:
    x-apievangelist-phrasing:
      intent: Report token usage for completions
      effect: read
      questions:
      - How many input and output tokens did we use on chat and completions this week?
      - Can I separate batch token usage from regular requests?
      - Which model consumed the most completion tokens per day?
      instructions:
      - text: Show completions token usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Show completion tokens for models {models} since {start_time} in {bucket_width} buckets.
        slots:
          models: query.models
          start_time: query.start_time
          bucket_width: query.bucket_width
      - text: Show only batch completions usage since {start_time} where batch is {batch}.
        slots:
          start_time: query.start_time
          batch: query.batch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/embeddings'].get
  update:
    x-apievangelist-phrasing:
      intent: Report embeddings usage
      effect: read
      questions:
      - How many tokens have we sent to embedding models lately?
      - Can I see embedding usage broken down per user?
      instructions:
      - text: Show embeddings usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Show embedding tokens for users {user_ids} since {start_time}.
        slots:
          user_ids: query.user_ids
          start_time: query.start_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/images'].get
  update:
    x-apievangelist-phrasing:
      intent: Report image generation usage
      effect: read
      questions:
      - How many images did we generate or edit this month?
      - Can I filter image usage by image size or by whether it was a generation or an edit?
      instructions:
      - text: Show image usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Show {sizes} image usage from {sources} since {start_time}.
        slots:
          sizes: query.sizes
          sources: query.sources
          start_time: query.start_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/moderations'].get
  update:
    x-apievangelist-phrasing:
      intent: Report moderation usage
      effect: read
      questions:
      - How much have we used the moderation endpoint recently?
      - Which projects send the most content through moderation checks?
      instructions:
      - text: Show moderation usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Group moderation usage since {start_time} by {group_by}.
        slots:
          start_time: query.start_time
          group_by: query.group_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/usage/vector_stores'].get
  update:
    x-apievangelist-phrasing:
      intent: Report vector store storage usage
      effect: read
      questions:
      - How many bytes are we storing across our vector stores?
      - Can I track vector store storage per project over time?
      instructions:
      - text: Show vector store usage since {start_time}.
        slots:
          start_time: query.start_time
      - text: Show vector store storage for projects {project_ids} since {start_time}.
        slots:
          project_ids: query.project_ids
          start_time: query.start_time
      method: generated
      generated: '2026-09-26'