​

Personalized Models API

• GET /api/personalized/v1/models

• Canonical models list: GET /api/v1/models
• Subscription‑only list: GET /api/subscription/v1/models
• Paid‑only list: GET /api/paid/v1/models

​

Compatibility & Response Shape

{
  "object": "list",
  "data": [ { /* model */ }, ... ]
}

{
  "id": "openai/gpt-5.2",
  "object": "model",
  "created": 1736966400,
  "owned_by": "openai"
}

​

Authentication

• Authorization: Bearer <api_key>
• or x-api-key: <api_key>

​

Personalization Rules

• The list is filtered by your account’s visible text models (configured in the NanoGPT web app under Settings → Models → “Visible Text Models”).
• This endpoint ignores the user preference “Also show paid models.” If you marked paid models as visible, they appear here even if you generally hide paid models elsewhere.
• If you have not set any preferences, the endpoint falls back to NanoGPT defaults (visible === true in our model registry).

​

Examples

curl -H "Authorization: Bearer $NANOGPT_API_KEY" \
  https://nano-gpt.com/api/personalized/v1/models

curl -H "x-api-key: $NANOGPT_API_KEY" \
  "https://nano-gpt.com/api/personalized/v1/models?detailed=true"

{
  "id": "openai/gpt-5.2",
  "object": "model",
  "created": 1736966400,
  "owned_by": "openai",
  "name": "GPT-5.2",
  "description": "OpenAI flagship general-purpose model",
  "context_length": 128000,
  "capabilities": { "vision": false },
  "pricing": {
    "prompt": 2.50,
    "completion": 10.00,
    "currency": "USD",
    "unit": "per_million_tokens"
  },
  "icon_url": "/icons/OpenAI.svg",
  "cost_estimate": {
    "cheap": false
  }
}

​

Managing Your Visible Models

• Open Settings → Models → “Visible Text Models”.
• Toggle visibility and categories as needed; changes are saved to your account.

• GET /api/user/model-visibility — returns your saved preferences as { modelPreferences: { visibleTextModels, modelCategories } }.
• POST /api/user/model-visibility — upserts preferences. Cookie‑based session auth is required (not API‑key auth).

{
  "visibleTextModels": {
    "openai/gpt-5.2": true,
    "anthropic/claude-opus-4.5": false
  },
  "modelCategories": {
    "openai/gpt-5.2": "General"
  }
}

​

Notes

• This route is explicitly dynamic (no shared caching across keys).
• Model ids and metadata evolve as providers update their catalogs; keep consumers resilient to new fields.
• Personalized results may include paid models even if /api/v1/models hides them for your account (by design).