API Reference
Subscriptions
Subscribe to a hoster's plan and get a scoped API key. Manage subscriptions via the portal or API.
Browse hosters
Find hosters and their plans at llmfinder.net/hosters or via API:
GET /v1/hosters
Authorization: Bearer ngk_your_key
Subscribe to a plan POST
POST /v1/subscriptions
Authorization: Bearer ngk_your_key
{
"product_id": "uuid-of-the-plan"
}
Response includes a scoped API key — use this key to call that specific hoster's models:
{
"subscription_id": "sub_xxx",
"api_key": "ngk_scoped_key_here", // save this — shown once
"product_name": "Basic Plan",
"status": "active",
"period_end": "2026-05-14T00:00:00Z"
}
⚠️ The scoped API key is shown only once. Save it immediately.
Using your subscription key
Use the scoped key like any other API key. Calls are automatically routed to the subscribed hoster:
from openai import OpenAI
client = OpenAI(
api_key="ngk_scoped_key_here",
base_url="https://api.llmfinder.net/v1"
)
response = client.chat.completions.create(
model="auto", # routes to your subscribed hoster
messages=[{"role": "user", "content": "Hello!"}]
)
List subscriptions GET
GET /v1/subscriptions
Authorization: Bearer ngk_your_key
Cancel subscription DELETE
DELETE /v1/subscriptions/{subscription_id}
Authorization: Bearer ngk_your_key
Cancellation immediately revokes the scoped API key. Access stops working right away.
Managing via portal
In your customer portal → 📋 My Subscriptions:
- See all active subscriptions with status and renewal dates
- Cancel any subscription with a 2-click confirmation
- Browse new hosters at llmfinder.net/hosters