ModelRush developer tools

OpenAPI, Postman, examples, and provider-neutral compatibility checks for the ModelRush API.

ModelRush provides an OpenAI-compatible API for text, image, video, and voice models, with published per-model pricing, regional routing, and request-level observability.

What is included

• compatibility-test/: a dependency-free Node.js check for discovery, authentication boundaries, and optional OpenAI-compatible chat behavior.
• openapi/: the ModelRush public OpenAPI 3.1 description and its validator.
• postman/: an importable Postman Collection and environment with billable requests disabled by default.
• examples/: Vercel AI SDK, TypeScript, Python, and cURL examples using maintained compatible clients.
• static-explorer/: a four-language, no-key model explorer with a dated, reproducible catalog snapshot, suitable for free static Hugging Face Spaces.
• hugging-face-space/: the optional live Gradio variant; not the deployed static explorer.

Quick start

Run the safe, non-billable compatibility checks without an API key:

node compatibility-test/check.mjs --base-url https://api.modelrush.ai/v1

Discover currently available models and regions:

curl https://api.modelrush.ai/v1/models
curl https://api.modelrush.ai/v1/regions

Model availability changes. Query discovery before pinning a model or execution region in production.

Validate the repository

npm install
npm test

The example test uses a loopback-only mock API. It does not create production usage. Python is optional locally; set MODELRUSH_EXAMPLE_PYTHON to a Python 3.10+ interpreter with the pinned dependency installed to include it.

Documentation and support

• Documentation
• Quickstart
• Model catalog
• Current pricing
• Agent integration guide

Security reports should follow SECURITY.md. Other questions: [email protected].

License

Apache License 2.0. See LICENSE and NOTICE.