Character Models - NanoGPT API Documentation

Overview

/api/v1/character-models returns approved public characters that are enabled for API use in a model-list-compatible shape. Use this endpoint when you want to sync available public characters into tools that already understand model list responses.

Endpoint

GET https://nano-gpt.com/api/v1/character-models

Query parameters:

Field	Type	Description
`detailed`	boolean	Include slug and extended character metadata
`cursor`	string	Pagination cursor
`limit`	number	Page size

Example

curl "https://nano-gpt.com/api/v1/character-models?detailed=true"

Response:

{
  "object": "list",
  "data": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "object": "model",
      "created": 1760000000,
      "owned_by": "nanogpt",
      "character": {
        "character_id": "11111111-1111-1111-1111-111111111111",
        "slug": "helpful-guide",
        "base_model_id": "deepseek-ai/DeepSeek-V3-0324",
        "content_rating": "sfw",
        "tags": ["writing"],
        "rating_avg": 4.8,
        "rating_count": 12
      }
    }
  ],
  "next_cursor": null
}

Pass the returned character.character_id as character_id to the Responses API.