English Français العربية

AI-Cost-CLI

السجل الرسمي الوسائط والتصميم

AI API cost calculator, recommender & MCP server. 29 models across text/image/video/audio.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع AI-Cost-CLI؟

  • Infrastructure Comparison: Compare Direct providers vs. Aggregators (OpenRouter) and Gateways (Portkey, LiteLLM, Martian).
  • Transparent Commissions: Automatically calculates platform fees (e.g., OpenRouter's 5.5% credit fee).
  • Direct Cost Calculation: Full breakdown of base costs and platform middle-layer fees.
  • Currency Conversion: Real-time conversion to local currencies (TRY, EUR, etc.) with offline fallback.
  • Automated Pricing: Weekly automated updates from official provider documentation.
  • MCP Server: Native support for AI agents (Cursor, Claude Desktop).

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package aicost-cli
Claude Code 
claude mcp add ai-cost-cli -- uvx aicost-cli==1.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ai-cost-cli": {
            "command": "uvx",
            "args": [
                "aicost-cli==1.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AI-Cost-CLI
  2. Preview: Direct vs. Aggregator Comparison
  3. Supported Models
  4. Features
  5. Installation
  6. Usage
  7. MCP Server
  8. Registries
  9. Contributing
  10. Community
  11. License

AI-Cost-CLI

A terminal-based calculator and recommendation engine for AI API costs. Supports multiple providers, local currency conversion, and automated pricing updates.

Preview: Direct vs. Aggregator Comparison

Compare the effective cost of using models directly vs. through gateways like OpenRouter, including platform fees.

                    Comparison: gpt-4o vs openrouter/gpt-4o                     
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Attribute        ┃             gpt-4o              ┃    openrouter/gpt-4o    ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Provider         │             OpenAI              │       OpenRouter        │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Source           │             Direct              │       Aggregator        │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Platform Fee     │              0.0%               │          5.5%           │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Type             │              text               │          text           │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Input Cost       │        111.4775 TRY (1M)        │    117.6088 TRY (1M)    │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Output/Unit Cost │        445.9100 TRY (1M)        │    470.4350 TRY (1M)    │
└──────────────────┴─────────────────────────────────┴─────────────────────────┘

Supported Models

Text Models
ModelProviderInput/1MOutput/1MTags
Claude Opus 4.7Anthropic$5.00$25.00reasoning, coding, vision, agentic
GPT-5.5OpenAI$5.00$30.00multimodal, coding, agentic
GPT-5.5 ProOpenAI$30.00$180.00precision, enterprise, agentic
Claude Sonnet 4.6Anthropic$3.00$15.00coding, fast, general
GPT-4oOpenAI$2.50$10.00reasoning, coding, vision
Gemini 3.1 ProGoogle$2.00$12.00long-context, multimodal
DeepSeek R1DeepSeek$0.55$2.19reasoning, coding, smart
Gemini 2.5 FlashGoogle$0.30$2.50fast, reasoning, legacy
Gemini 3.1 Flash-LiteGoogle$0.25$1.50fast, cheap, agentic
DeepSeek V3DeepSeek$0.14$0.28general, coding, cheap
Image, Video & Audio Models
ModelProviderPriceType
Imagen 4 FastGoogle$0.02/imageImage
GPT-Image-1OpenAI$0.02/imageImage
DALL-E 3OpenAI$0.04/imageImage
Imagen 4 UltraGoogle$0.06/imageImage
Veo 3 LiteGoogle$0.05/secVideo
Veo 3Google$0.40/secVideo
Lyria 3 ClipGoogle$0.04/clipMusic
Lyria 3 ProGoogle$0.08/songMusic
WhisperOpenAI$0.006/minSpeech-to-Text
TTS StandardOpenAI$15/1M charsText-to-Speech

Full list available via aicost list --currency USD

Features

  • Infrastructure Comparison: Compare Direct providers vs. Aggregators (OpenRouter) and Gateways (Portkey, LiteLLM, Martian).
  • Transparent Commissions: Automatically calculates platform fees (e.g., OpenRouter's 5.5% credit fee).
  • Direct Cost Calculation: Full breakdown of base costs and platform middle-layer fees.
  • Currency Conversion: Real-time conversion to local currencies (TRY, EUR, etc.) with offline fallback.
  • Automated Pricing: Weekly automated updates from official provider documentation.
  • MCP Server: Native support for AI agents (Cursor, Claude Desktop).

Installation

pip install aicost-cli

With MCP server support:

pip install aicost-cli[mcp]

Or from source:

git clone https://github.com/ufhouck/aicost.git
cd aicost
pip install -e .

Usage

List All Models
aicost list --currency TRY
Calculate Cost
# Text model — token-based
aicost calc claude-opus-4.7 --input 1000000 --output 500000 --currency TRY

# With platform fee breakdown (aggregators)
aicost calc openrouter/gpt-4o --input 1000000 --output 500000 --currency TRY

Output Example:

╭───────── Cost Calculation ──────────╮
│ Model: openrouter/gpt-4o            │
│ Source: Aggregator                  │
│                                     │
│ Base Cost: 316.9976 TRY             │
│ Platform Fee (5.5%): 17.4349 TRY    │
│                                     │
│ Total Cost: 334.4325 TRY            │
╰─────────────────────────────────────╯
Compare Models
aicost compare claude-opus-4.7 gpt-5.5 --currency USD
Get Recommendations
aicost recommend "fast cheap coding" --currency USD
Sync Latest Pricing
aicost sync

MCP Server

Start the Model Context Protocol server for AI agent integration:

aicost mcp

Registries

Contributing

See CONTRIBUTING.md for guidelines on how to contribute, including pricing updates, bug reports, and code contributions.

Community

License

MIT — see LICENSE for details. Developed by Ufuk Aydın.

الأسئلة الشائعة

ما هو AI-Cost-CLI؟

AI API cost calculator, recommender & MCP server. 29 models across text/image/video/audio.

كيف أثبّت AI-Cost-CLI؟

يعمل على جهازك. في Claude Code: claude mcp add ai-cost-cli -- uvx aicost-cli==1.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AI-Cost-CLI إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل AI-Cost-CLI مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AI-Cost-CLI؟

ينشره ufhouck. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.