Skip to main content
Glama

Quick start

npx --yes @i2v-ai/cli list --type image --json
npx --yes @i2v-ai/cli price gpt-image-2

list, doc and price read the public catalog and need no API key. Install it globally for repeated use:

npm install --global @i2v-ai/cli
brew install i2v-ai/tap/i2v

Related MCP server: runninghub-mcp

Generate with a budget

export I2V_API_KEY="YOUR_API_KEY"
i2v plan gpt-image-2 --input-file inputs.json
i2v run gpt-image-2 --input-file inputs.json --max-cost-usd 0.20 \
  --expected-revision REVISION --idempotency-key order-1234 --no-wait
i2v status TASK_ID --wait 120 --out ./result.png
  • plan validates the inputs and returns the account quote plus the model revision.

  • run submits only inside the approved USD ceiling and keeps the idempotency key you supply.

  • status --wait retries HTTP 429, 502, 503 and 504 inside the same deadline, honoring Retry-After.

  • recover OPERATION_ID looks up the original receipt when the submit response was lost.

Commands

Command

Purpose

list / doc / price

Public catalog, model documentation, USD rates

plan / quote

Validate inputs and quote the account reservation

upload

Upload and verify a local reference file

run

Submit with a ceiling, wait or return a receipt

status / recover

Continue a task or recover a lost submission

balance / usage

USD balance and settled usage

doctor

Check the CLI, API and MCP configuration

mcp

Start the local stdio MCP server

Full reference: i2v.ai/cli.

For AI agents

Repository

Purpose

i2v-sdk-js

TypeScript SDK

i2v-sdk-python

Python SDK

i2v-skills

Agent Skills and plugin manifests

i2v-mcp

Remote MCP metadata and registry publication

generate-action

GitHub Action

i2v-api-examples

Runnable API examples

i2v-agent-tools

Ecosystem hub

License

MIT. See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers