Public API

How do we use the API?

Currently, the API is not working/functional as again, very early beta, haha. We plan to have this available on the first public release.

In the meantime, if you'd like to prepare yourself for the public release, you can use the endpoint URL https://api.charactercards.app/v1

We have a fair usage policy of no more than 10 requests/minute. Additionally, the endpoints do NOT support streaming as of this moment. We plan to implement this soon.

What can I do with the API?

The API will allow you to do a variety of things, such as:

  • Search for characters based on various parameters, such as name, description, tags, and more.
  • Retrieve detailed information about specific characters, including their descriptions, associated LLMs, usage contexts, and images.
  • Use limited models to talk with characters directly.

How do I get access?

The API will be publicly available to everyone on the first public release. For chatting, which follows the OpenAI specifications for communicating with models, there will be no keys required.

For anything dealing with CharacterCards directly, we ask that you email us (developer@charactercards.app) to request access. We'll get back to you as soon as possible and will also provide documentation for the endpoints as needed.

Hmm.. do you guys log my requests?

As we're just as.. spicy with our own interests, no. We, ourselves, don't log any requests or user data sent with said requests. NOW, lets clarify this for you.

Again, we, ourselves do not retain or log any data. We do use third-parties for model access, such as OpenRouter (who can log requests if we asked them to, we don't.), Chutes or DeepSeek. These providers may log data sent to them, while we ask them not to, in order to train future models.

That being said, we do have to use these providers in order to provide the best experience possible for our users, and as such, we have to abide by their policies. If you have any concerns about this, please feel free to reach out to us.