Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nano-gpt.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
FieldTypeDescription
detailedbooleanInclude slug and extended character metadata
cursorstringPagination cursor
limitnumberPage 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.