Query OpenAI dollar-amount spend data.

USE THIS TOOL FOR:

• Total spend over a date range (summary mode, default)

• Daily cost breakdown by line item or project

• Month-to-date spend with projected month-end forecast

• Identifying cost anomalies (spike days highlighted in summary)

DO NOT USE THIS TOOL FOR:

• Token or request counts (use 'usage' tool instead)

• Comparing two different months side by side (use 'cost-comparison' tool)

DETAIL LEVELS:

• summary (default): Compact total + top-N breakdown table (~20 lines). Includes projected month-end spend and anomaly detection when applicable.

• daily: Per-day breakdown with per-item amounts.

• raw: Full unprocessed data, every line item every day.

DEFAULTS: detail_level='summary', group_by='line_item', top_n=10, end_time=today

EXAMPLES:

• This month's spend: start_time="2026-03-01"

• Last 7 days by project: start_time="2026-03-23", group_by="project_id"

• Daily breakdown for February: start_time="2026-02-01", end_time="2026-03-01", detail_level="daily"

Dates in YYYY-MM-DD format.

Query OpenAI token and request usage data by service type.

USE THIS TOOL FOR:

• Token consumption (input, output, cached) by model

• Request counts over time

• Usage breakdown by model, project, or API key

• Image generation counts, audio seconds, etc.

DO NOT USE THIS TOOL FOR:

• Dollar-amount costs (use 'costs' tool instead)

• Month-over-month cost comparisons (use 'cost-comparison' tool)

SERVICE TYPES: completions, embeddings, images, audio_speeches, audio_transcriptions, moderations, vector_stores, code_interpreter_sessions

DETAIL LEVELS:

• summary (default): Compact table aggregated by model with totals.

• daily: Per-day breakdown.

• raw: Full unprocessed data.

DEFAULTS: detail_level='summary', bucket_width='1d', top_n=10, end_time=today

EXAMPLES:

• GPT-4o usage this month: service_type="completions", start_time="2026-03-01", models="gpt-4o"

• All completions last week: service_type="completions", start_time="2026-03-23"

• Embeddings by project: service_type="embeddings", start_time="2026-03-01", group_by="project_id"

Dates in YYYY-MM-DD format.

Compare OpenAI costs between two months to identify spending changes.

USE THIS TOOL FOR:

• Month-over-month cost variance analysis (e.g., February vs March)

• Identifying which line items increased or decreased the most

• Executive-level cost change summaries

DO NOT USE THIS TOOL FOR:

• Single-month cost analysis (use 'costs' tool instead)

• Token or request usage data (use 'usage' tool instead)

• Arbitrary date range comparisons (this tool compares full calendar months only)

PARAMETERS:

• baseline_month: Earlier month in YYYY-MM format (e.g., "2026-02")

• comparison_month: Later month in YYYY-MM format (e.g., "2026-03")

• group_by: "line_item" (default), "project_id", or both

• top_n: Number of items to show (default 10)

OUTPUT includes:

• Total spend for each month with overall delta and % change

• Per-line-item comparison table with delta and % change

• Biggest movers section highlighting largest increase and decrease

EXAMPLES:

• February vs March: baseline_month="2026-02", comparison_month="2026-03"

• By project: baseline_month="2026-02", comparison_month="2026-03", group_by="project_id"