Spaces:
Running
Running
| title: README | |
| emoji: ⚡ | |
| colorFrom: indigo | |
| colorTo: pink | |
| sdk: static | |
| pinned: false | |
| license: mit | |
| <div class="grid lg:grid-cols-3 gap-x-4 gap-y-6"> | |
| <div class="lg:col-span-3"> | |
| <h1>Modelflare</h1> | |
| <p> | |
| Stable, lower-cost <strong>AI API gateway</strong> for LLM, image, and video models. | |
| One key for OpenAI-compatible Chat & Responses, Anthropic Messages, plus native image and video contracts — | |
| with ordered model-group fallbacks, per-request usage & cost tracking, Smart keys, and cache hit guarantee. | |
| </p> | |
| </div> | |
| <a href="https://modelflare.dev/?utm_source=huggingface&utm_medium=org&utm_campaign=card" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-indigo-50 to-pink-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">Console & Pricing</span> | |
| </div> | |
| <div class="underline">modelflare.dev</div> | |
| </a> | |
| <a href="https://docs.modelflare.dev/?utm_source=huggingface&utm_medium=org&utm_campaign=card" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-indigo-50 to-pink-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">API Docs</span> | |
| </div> | |
| <div class="underline">docs.modelflare.dev</div> | |
| </a> | |
| <a href="https://huggingface.co/collections/Modelflare/modelflare-getting-started" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-amber-50 to-orange-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">Getting Started</span> | |
| </div> | |
| <div class="underline">Hub collection · start here</div> | |
| </a> | |
| <a href="https://huggingface.co/spaces/Modelflare/start" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-violet-50 to-fuchsia-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">Start here → Console</span> | |
| </div> | |
| <div class="underline">Hub landing</div> | |
| </a> | |
| <a href="https://huggingface.co/spaces/Modelflare/openai-sdk" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-blue-50 to-purple-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">OpenAI SDK guide</span> | |
| </div> | |
| <div class="underline">One-line base_url switch</div> | |
| </a> | |
| <a href="https://huggingface.co/spaces/Modelflare/coding-agents" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-indigo-50 to-pink-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">Coding Agents</span> | |
| </div> | |
| <div class="underline">Codex · Claude Code · Gemini CLI</div> | |
| </a> | |
| <a href="https://huggingface.co/spaces/Modelflare/api-recipes" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-rose-50 to-orange-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">API Recipes</span> | |
| </div> | |
| <div class="underline">curl · Python · endpoint picker</div> | |
| </a> | |
| <a href="https://huggingface.co/datasets/Modelflare/api-examples" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-emerald-50 to-teal-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">API Examples Dataset</span> | |
| </div> | |
| <div class="underline">JSONL request sketches</div> | |
| </a> | |
| <a href="https://huggingface.co/spaces/Modelflare/blog" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-sky-50 to-indigo-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">Blog</span> | |
| </div> | |
| <div class="underline">Setup guides and engineering notes</div> | |
| </a> | |
| <a href="https://docs.modelflare.dev/guides/features/?utm_source=huggingface&utm_medium=org&utm_campaign=card" class="block overflow-hidden group"> | |
| <div class="w-full h-28 mb-2 rounded-lg flex items-center justify-center bg-gradient-to-br from-indigo-50 to-pink-50 border border-gray-100 px-4"> | |
| <span class="text-lg font-semibold text-gray-800">Platform Features</span> | |
| </div> | |
| <div class="underline">Failover · Smart keys · Cache guarantee</div> | |
| </a> | |
| <div class="lg:col-span-3"> | |
| <h2>What you get</h2> | |
| <ul> | |
| <li><strong>One key</strong> for text, image, and video models</li> | |
| <li><strong>OpenAI-compatible</strong> chat — point your SDK at <code>https://modelflare.dev/v1</code></li> | |
| <li><strong>Group failover</strong> so one unavailable route does not fail the request</li> | |
| <li><strong>Per-request</strong> token, image, and video cost records</li> | |
| <li><strong>Smart keys</strong> and <strong>cache hit guarantee</strong></li> | |
| <li>Guides for <strong>Codex, Claude Code, Gemini CLI</strong>: see the Coding Agents Space and the <a href="https://huggingface.co/spaces/Modelflare/blog">Blog</a></li> | |
| </ul> | |
| </div> | |
| <div class="lg:col-span-3"> | |
| <h2>Quick start</h2> | |
| <div class="p-4 bg-gradient-to-b from-gray-50 to-white border border-gray-100 rounded-lg relative mb-2"> | |
| <pre class="break-words whitespace-pre-line text-xs md:text-sm text-gray-800">from openai import OpenAI | |
| client = OpenAI( | |
| api_key="YOUR_MODELFLARE_API_KEY", | |
| base_url="https://modelflare.dev/v1", | |
| ) | |
| r = client.chat.completions.create( | |
| model="gpt-5.6-sol", # must be enabled on your group | |
| messages=[{"role":"user","content":"Hello from Hugging Face"}], | |
| ) | |
| print(r.choices[0].message.content)</pre> | |
| </div> | |
| <p> | |
| Create a key in the <a href="https://modelflare.dev/?utm_source=huggingface&utm_medium=org&utm_campaign=card" class="underline">console</a>, | |
| then switch <code>base_url</code> to <code>https://modelflare.dev/v1</code>. | |
| Full guides: <a href="https://docs.modelflare.dev/?utm_source=huggingface&utm_medium=org&utm_campaign=card" class="underline">docs.modelflare.dev</a> | |
| · SDK walkthrough: <a href="https://huggingface.co/spaces/Modelflare/openai-sdk" class="underline">openai-sdk</a> | |
| · recipes: <a href="https://huggingface.co/spaces/Modelflare/api-recipes" class="underline">api-recipes</a> | |
| · agents: <a href="https://huggingface.co/spaces/Modelflare/coding-agents" class="underline">coding-agents</a> | |
| · blog: <a href="https://huggingface.co/spaces/Modelflare/blog" class="underline">Modelflare/blog</a>. | |
| </p> | |
| </div> | |
| <div class="lg:col-span-3"> | |
| <p> | |
| This Hub organization hosts Modelflare demos, examples, and community Spaces. | |
| Feedback welcome in the | |
| <a href="https://huggingface.co/spaces/Modelflare/start/discussions/1" class="underline">start Space discussion #1</a>. | |
| Interactive Gradio Chat Demo ships after HF PRO; until then use the console + API path above. | |
| </p> | |
| </div> | |
| </div> | |