diff --git a/hub/api-keys.md b/hub/api-keys.md new file mode 100644 index 0000000..55c1e62 --- /dev/null +++ b/hub/api-keys.md @@ -0,0 +1,62 @@ +--- +title: API Keys +--- + +# API Keys + +The **API Keys** page is where you create keys for **HPP Router** — HPP's AI model +gateway — and browse the models you can call from your own code. + +## Create an API key + +1. Open **API Keys** from the left sidebar. +2. Select **Create Key** and give it a name. +3. Copy the key and store it somewhere safe. + +You can create several keys and revoke any of them at any time. Treat a key like a +password — keep it server-side and never commit it to source control. + +> **Note:** API usage and the Playground draw from the same **Credits**. Top up on the +> [Wallets](./wallets) page. + +## Browse available models + +The page lists every model HPP Router can route to, in two tables: + +- **Text models** — chat and code models from providers such as Anthropic (Claude), + OpenAI (GPT), and Moonshot AI (Kimi), plus free open models. Each shows its input and + output price per million tokens (MTok). +- **Image models** — image-generation models, priced the same per-use way. + +The list and prices shown in the Hub are always current, so check there for the +definitive catalog. + +## Make a request + +Your key works with any OpenAI-compatible client. Point the base URL at HPP Router and +send the key as a Bearer token: + +```bash +curl https://router.hpp.io/llm/v1/chat/completions \ + -H "Authorization: Bearer YOUR_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "model": "hpprouter/auto", + "max_tokens": 1024, + "messages": [{"role": "user", "content": "Hello!"}] + }' +``` + +The virtual `hpprouter/auto` model lets HPP Router pick a cost-appropriate model for each +request. To call a specific model, use its full id (for example `anthropic/claude-sonnet-4-6`). + +## Full HPP Router guide + +API keys are issued for **HPP Router**, HPP's OpenAI-compatible model gateway. For the +complete reference — authentication, streaming, the model catalog and pricing, smart +routing, and SDKs — see the dedicated guide: + +- [HPP Router overview](/hpp-router) +- [Quickstart](/hpp-router/quickstart) +- [Authentication](/hpp-router/authentication) +- [Models & Pricing](/hpp-router/models-and-pricing) diff --git a/hub/faq.md b/hub/faq.md index 3acf80f..6cd8d91 100644 --- a/hub/faq.md +++ b/hub/faq.md @@ -23,8 +23,14 @@ available on the production Hub. ### Which AI models can I use? -A wide range, including Claude, GPT, Llama, and Qwen models. The full list and pricing is -on the **Wallets** page in the Hub. +A wide range, including Claude, GPT, and Kimi models, plus free open models. The full list +and pricing is on the **[API Keys](./api-keys)** page in the Hub — these models are served +by [HPP Router](/hpp-router). + +### Can I use the AI models from my own code? + +Yes. Create an API key on the **[API Keys](./api-keys)** page and call the models through +[HPP Router](/hpp-router), HPP's OpenAI-compatible gateway. ### Are my conversations private? diff --git a/hub/getting-started.md b/hub/getting-started.md index 428e399..c5ebca4 100644 --- a/hub/getting-started.md +++ b/hub/getting-started.md @@ -17,8 +17,10 @@ Once you're signed in, the left sidebar has everything you need: - **Home** — start a new build or pick a guided prompt - **Playground** — build apps and games, and chat with AI models -- **Wallets** — your Credits, wallet, and API keys +- **Wallets** — your Credits and on-chain wallets +- **API Keys** — issue keys for HPP Router and browse available models - **Settings** — account, security, and invites +- **Support** — get help from the HPP team A secure wallet on HPP Mainnet is created for you automatically — no setup required. diff --git a/hub/intro.md b/hub/intro.md index 11631ad..2472fb7 100644 --- a/hub/intro.md +++ b/hub/intro.md @@ -24,8 +24,10 @@ preview you can test and publish. ## What's inside - **Playground** — describe what to build, preview and publish it, and chat with leading - AI models (Claude, GPT, Llama, Qwen). -- **Wallets** — your Credit balance, a built-in wallet on HPP Mainnet, and API keys. + AI models (Claude, GPT, Kimi, and more). +- **Wallets** — your Credit balance and your on-chain wallets on HPP Mainnet. +- **API Keys** — issue keys for [HPP Router](/hpp-router) and call HPP's AI models from + your own code. - **Credits** — pay-as-you-go, topped up with USDC.e on HPP Mainnet. ## Verifiable by design diff --git a/hub/playground.md b/hub/playground.md index cde7074..80dd12a 100644 --- a/hub/playground.md +++ b/hub/playground.md @@ -24,8 +24,8 @@ Your projects save automatically — continue from **Home** or the project list. ## Chat with AI models -The Playground is also a chat with AI models provided through **HPP Router**. Pick a model -from the selector at the top: +The Playground is also a place to **chat with leading AI models**. Pick a model from the +selector at the top: - **Claude Sonnet 4.6** — latest Claude Sonnet, excellent coder - **Claude Haiku 4.5** — fast and efficient @@ -33,7 +33,7 @@ from the selector at the top: - **GPT-5 Mini** — lightweight but intelligent - **GPT-OSS 120B** — open-source model -…and more. See the full list and pricing in [Wallets](./wallets#available-models). +…and more. See the full list and pricing on the [API Keys](./api-keys) page. ## Verify a response on-chain diff --git a/hub/wallets.md b/hub/wallets.md index 7453f7c..76c6b26 100644 --- a/hub/wallets.md +++ b/hub/wallets.md @@ -4,38 +4,25 @@ title: Wallets # Wallets -The **Wallets** page is where you manage Credits, your on-chain wallet, and API keys. +The **Wallets** page is where you manage your **Credits** and your on-chain wallets. + +> **Note:** API keys are managed on the [API Keys](./api-keys) page. ## Credits Your **Credit balance** powers everything you do in HPP Hub — building, previews, and AI chat. Usage is pay-as-you-go. -To add Credits, select **Buy Credit** and pay with **USDC.e on HPP Mainnet**. - -## Your wallet - -HPP Hub gives every member a secure, non-custodial **wallet on HPP Mainnet** — created -automatically, with no setup required. You can view its address and any NFTs you've minted -from the Wallets page. - -### Connect a personal wallet (optional) - -You can also connect your own EVM-compatible wallet to link your address and view your -staked HPP. - -## API keys - -Create an **API key** on the Wallets page to use HPP Hub's AI models from your own code. -Keep your keys secret; you can create and revoke them at any time. +To add Credits, select **Buy Credit** and pay with **USDC.e on HPP Mainnet**. -## Available models +## Personal Wallet (EOA) -HPP Hub offers a wide range of AI models, provided through **HPP Router** — dozens of text -models and image models, each with its own per-use pricing. +Connecting a personal wallet is **optional**. Use **Connect Wallet** to link your own +EVM-compatible wallet — this lets you link your address and view your **staked HPP** +amount. -The **full, always-current list of models and prices** is shown on the **Wallets** page in -the Hub. +## MPC Wallet -> **Note:** a dedicated **HPP Router** guide — covering the API and the complete model -> catalog — is coming soon. +Every member gets a secure **MPC wallet on HPP Mainnet**, created automatically with no +setup required. From the Wallets page you can view its address (with a link to the block +explorer) and any NFTs you've minted. diff --git a/sidebarsHub.ts b/sidebarsHub.ts index 3dae2d2..0882c1a 100644 --- a/sidebarsHub.ts +++ b/sidebarsHub.ts @@ -9,6 +9,7 @@ const sidebars: SidebarsConfig = { 'getting-started', 'playground', 'wallets', + 'api-keys', 'settings', 'faq', ],