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