# Core API Reference

This section provides a detailed overview of Convai’s **Core APIs**, which serve as the foundation for building intelligent and interactive virtual characters. The Core APIs are divided into two main categories: **Character Crafting APIs** and **Interaction APIs**, each serving a distinct purpose in your development workflow.

{% embed url="<https://youtu.be/vwBzaQP0Bl4?si=tQ5LGv-F9nxwxv1u>" %}

### Understanding the Core API

Convai’s Core API empowers developers to **create, customize, and deploy AI-driven characters** across various use cases — from immersive games to virtual assistants.

The Core API is structured into two segments:

{% content-ref url="/spaces/EtUJA212Zc1S9ACc8T4l/pages/gsTUYbL4ZFKCtOINokQj" %}
[Character Crafting APIs](/api-docs/api-reference/core-api-reference/character-crafting-apis.md)
{% endcontent-ref %}

{% content-ref url="/spaces/EtUJA212Zc1S9ACc8T4l/pages/hIPRKZO2HDe3YYFi3g7J" %}
[Interaction APIs](/api-docs/api-reference/core-api-reference/interaction-apis.md)
{% endcontent-ref %}

***

{% hint style="danger" %}
**Heads Up**

Misuse of this API for unethical or malicious purposes will result in an automatic ban of the associated account and API key.
{% endhint %}

{% hint style="info" %}
For additional resources, you can also explore our [Python Notebook](https://colab.research.google.com/drive/17Bazf92ZsXQmJZ91CbVAhiPmnapIuTgS?usp=sharing).&#x20;

This notebook is a hands-on guide to using Convai’s Core APIs for creating responsive NPCs. It walks you through setting up a character, defining its narrative and backstory, and integrating voice capabilities effectively.
{% endhint %}

{% hint style="success" %}
If you encounter any issues or have questions, please don’t hesitate to reach out to us through our [Convai Developer Forum](https://forum.convai.com).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/api-reference/core-api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.