wehub-resource-sync
97e91a83f3
Ruff / Ruff (push) Has been cancelled
Test / Core Tests (push) Has been cancelled
Test / Offline Coverage Tests (Python 3.10) (push) Has been cancelled
Test / Offline Coverage Tests (Python 3.11) (push) Has been cancelled
Test / Offline Coverage Tests (Python 3.12) (push) Has been cancelled
Test / Offline Coverage Tests (Python 3.13) (push) Has been cancelled
Test / Offline Coverage Tests (Python 3.9) (push) Has been cancelled
Test / Full Coverage (Python 3.11) (push) Has been cancelled
Test / Core Provider Tests (OpenAI) (push) Has been cancelled
Test / Core Provider Tests (Anthropic) (push) Has been cancelled
Test / Core Provider Tests (Google) (push) Has been cancelled
Test / Core Provider Tests (Other) (push) Has been cancelled
Test / Anthropic Tests (push) Has been cancelled
Test / Gemini Tests (push) Has been cancelled
Test / Google GenAI Tests (push) Has been cancelled
Test / Vertex AI Tests (push) Has been cancelled
Test / OpenAI Tests (push) Has been cancelled
Test / Writer Tests (push) Has been cancelled
Test / Auto Client Tests (push) Has been cancelled
ty / type-check (push) Has been cancelled
62 lines
3.1 KiB
Markdown
62 lines
3.1 KiB
Markdown
---
|
|
title: OpenAI API Usage CLI Guide
|
|
description: Learn how to monitor OpenAI API usage with the CLI tool, including commands for viewing data by model, date, and cost.
|
|
---
|
|
|
|
# Using the OpenAI API Usage CLI
|
|
|
|
The OpenAI API Usage CLI tool provides functionalities for monitoring your OpenAI API usage, breaking it down by model, date, and cost.
|
|
|
|
## Monitoring API Usage
|
|
|
|
### View Usage Options
|
|
|
|
```sh
|
|
$ instructor usage --help
|
|
|
|
Usage: instructor usage [OPTIONS] COMMAND [ARGS]...
|
|
|
|
Check OpenAI API usage data
|
|
|
|
╭─ Options ───────────────────────────────────────────────────────╮
|
|
│ --help Show this message and exit. │
|
|
╰─────────────────────────────────────────────────────────────────╯
|
|
╭─ Commands ──────────────────────────────────────────────────────╮
|
|
│ list Displays OpenAI API usage data for the past N days. │
|
|
╰─────────────────────────────────────────────────────────────────╯
|
|
```
|
|
|
|
### List Usage for Specific Number of Days
|
|
|
|
To display API usage for the past 3 days, use the following command:
|
|
|
|
```sh
|
|
$ instructor usage list --n 3
|
|
```
|
|
|
|
This will output a table similar to:
|
|
|
|
```plaintext
|
|
Usage Summary by Date, Snapshot, and Cost
|
|
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
|
|
┃ Date ┃ Snapshot ID ┃ Total Requests ┃ Total Cost ($) ┃
|
|
┡━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
|
|
│ 2023-09-04 │ gpt-5.4-mini │ 44 │ 0.68 │
|
|
│ 2023-09-04 │ gpt-5.4-mini │ 195 │ 0.84 │
|
|
│ 2023-09-04 │ text-embedding-ada-002-v2 │ 276 │ 0.00 │
|
|
│ 2023-09-04 │ gpt-4-32k-0613 │ 328 │ 49.45 │
|
|
└────────────┴───────────────────────────┴────────────────┴────────────────┘
|
|
```
|
|
|
|
### List Usage for Today
|
|
|
|
To display the API usage for today, simply run:
|
|
|
|
```sh
|
|
$ instructor usage list
|
|
```
|
|
|
|
# Contributions
|
|
|
|
We aim to provide a light wrapper around the API rather than offering a complete CLI. Contributions are welcome! Please feel free to make an issue at [jxnl/instructor/issues](https://github.com/jxnl/instructor/issues) or submit a pull request.
|