⚡ AI Model GitHub Action

Automate AI model data in your CI/CD pipeline. Free, open source, and always up-to-date.

Quick Start

- name: Get AI Model Data
  uses: i-need-token/ai-models@v0.2.0
  with:
    format: json
    output: models.json

Features

📊 Model Data

Get structured model data with pricing, context windows, and capabilities for 4,587+ models across 95 providers.

🔍 Filter & Search

Filter by provider, capability (tool calling, reasoning, vision), pricing tier, or context window size.

💰 Price Tracking

Monitor pricing changes across providers. Get alerts when model prices change.

📋 Format Options

Output as JSON, YAML, CSV, or Markdown table. Use in scripts, docs, or dashboards.

Action Inputs

Input	Description	Default
`format`	Output format: json, yaml, csv, markdown	`json`
`output`	Output file path	`models.json`
`provider`	Filter by provider name	(all)
`capability`	Filter by capability: tool_call, reasoning, vision, structured_output	(all)
`free-only`	Only include free models	`false`
`max-price`	Maximum input price per M tokens	(no limit)
`min-context`	Minimum context window size	0

Usage Examples

Get Free Models with Tool Calling

- name: Get free tool-calling models
  uses: i-need-token/ai-models@v0.2.0
  with:
    format: json
    output: free-tc-models.json
    capability: tool_call
    free-only: true

Get Cheapest Models Under $0.50/M

- name: Get budget models
  uses: i-need-token/ai-models@v0.2.0
  with:
    format: csv
    output: budget-models.csv
    max-price: 0.50

Generate Model Comparison Table

- name: Generate comparison table
  uses: i-need-token/ai-models@v0.2.0
  with:
    format: markdown
    output: model-comparison.md
    provider: openai
    capability: reasoning

Weekly Price Monitoring

name: Price Monitor
on:
  schedule:
    - cron: '0 6 * * 1'  # Every Monday 6:00 UTC
jobs:
  check-prices:
    runs-on: ubuntu-latest
    steps:
      - uses: i-need-token/ai-models@v0.2.0
        with:
          format: csv
          output: current-prices.csv
      - name: Compare with last week
        run: |
          diff last-week-prices.csv current-prices.csv || echo "Prices changed!"
      - name: Save for next week
        run: cp current-prices.csv last-week-prices.csv

Output Formats

JSON

{
  "generated_at": "2025-05-21T12:00:00Z",
  "stats": { "models": 4587, "providers": 95 },
  "models": [
    {
      "id": "gpt-4o",
      "provider": "openai",
      "pricing": { "input": 2.5, "output": 10 },
      "limit": { "context": 128000 },
      "tool_call": true,
      "reasoning": false
    }
  ]
}

CSV

id,provider,input_price,output_price,context_window,tool_call,reasoning
gpt-4o,openai,2.5,10,128000,true,false

Why Use This Action?

✅ Always up-to-date — data refreshed from provider APIs
✅ First-party data only — no third-party aggregators
✅ Structured & validated — TypeScript types + Zod schemas
✅ Zero configuration — works out of the box
✅ Free & open source — MIT license

View on GitHub → · Interactive Catalog →