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: