Upload README.md

README.md

@@ -1,10 +1,74 @@
 ---
 title: README
-emoji: 🔥
-colorFrom: red
-colorTo: purple
+emoji: ⚡
+colorFrom: indigo
+colorTo: pink
 sdk: static
 pinned: false
+license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+<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 &amp; Responses, Anthropic Messages, plus native image and video contracts —
+      with ordered model-group fallbacks and per-request usage &amp; cost tracking.
+    </p>
+  </div>
+
+  <a href="https://modelflare.dev/" 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 &amp; Pricing</span>
+    </div>
+    <div class="underline">modelflare.dev</div>
+  </a>
+
+  <a href="https://docs.modelflare.dev/" 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://docs.modelflare.dev/guides/features/" 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>Guides for <strong>Codex, Claude Code, Gemini CLI</strong>, and other coding agents</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">curl https://modelflare.dev/v1/chat/completions \
+  -H "Authorization: Bearer $MODELFLARE_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hello"}]}'</pre>
+    </div>
+    <p>
+      Create a key in the console, then switch your OpenAI client <code>base_url</code> to
+      <a href="https://modelflare.dev/" class="underline">https://modelflare.dev/v1</a>.
+      Full guides: <a href="https://docs.modelflare.dev/" class="underline">docs.modelflare.dev</a>.
+    </p>
+  </div>
+
+  <div class="lg:col-span-3">
+    <p>
+      This Hub organization hosts Modelflare demos, examples, and community Spaces.
+      Follow along for new Gradio / MCP Spaces and integration templates.
+    </p>
+  </div>
+</div>