UNITHdocs
Sign inarrow_forward
API

Advanced Conversational Settings (LLM Provider, external tools)

This section details the configuration options for managing core aspects of the digital human's conversational behavior, including the selection of the underlying Language Model (LLM) provider, model and external tool integrations.

info

The platform currently offers integration with the following LLM providers: OpenAI and Groq. We are actively developing support for further LLM providers, which will be available in upcoming updates.

Configure the LLM settings

Use the PUT /head/{id}/conversation-settings endpoint to configure the LLM settings for the Digital Human. The following parameters are required:

provider

Specify the exact LLM model to be used.

  • Expected value: string
  • Valid values:
    • "openai": Use an OpenAI model.
    • "groq": Use a Groq model.
  • Default value: "openai"

llm_name:

Specify the exact LLM model.

  • Expected value: string
  • Possible values: Refer to your chosen LLM provider's documentation (Groq, OpenAI) for a list of available models (e.g., "gpt-3.5-turbo", "gpt-4" for OpenAI).
  • Default value: "gpt-4o-mini"
warning_amber

The model name must be the exact, complete model identifier from your LLM provider's documentation. Many models include a specific version timestamp in their name (e.g., "gpt-4.1-mini-2025-04-14", "llama-3.3-70b-versatile"). Using an incorrect or incomplete model name will result in API errors. Always copy the full model string directly from your provider's official model list.

max_llm_tokens:

Specify the max. tokens per response.

  • Expected value: integer
  • Possible values: Refer to your chosen LLM provider's documentation for the maximum tokens per response.
  • Default value: "8000"

api_key:

Set the api_key of your llm provider service

  • Expected value: string

Example request:

Request body

code
curl -X 'PUT' \
  'https://platform-api.unith.ai/head/yourHeadId/conversation-settings' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer yourBearerToken' \
  -H 'Content-Type: application/json' \
  -d '{
"conversationSettings": {
  "chat_model_settings": {
     "provider": "openai",
     "llm_name": "gpt-4.1-mini-2025-04-14",
     "api_key":"yourApiKey"
  }
}
}'
info

Use GET /head/{id}/conversation-settings to retrieve the Digital Human's LLM settings.

The PUT method requires the complete conversationSettings object. Include all existing parameters you wish to retain, as omitted fields will revert to defaults.

Retrieve current Digital Human LLM settings

code
curl -X 'GET' \
  'https://platform-api.unith.ai/head/yourHeadId/conversation-settings' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer yourBearerToken'

Configure the external tools integration

Configure external tools that can be invoked by the digital human via HTTP POST requests. This enables the digital human to interact with external services and APIs during a conversation.

Please refer to the following documentation to learn more about tools.

scheduleLast updated Mar 4, 2026