# Hume AI Integration via LowCodeAPI

## Overview

Hume AI provides empathic voice interface (EVI) APIs for understanding and generating human emotional expression in voice.

## Base Endpoint

```
https://api.lowcodeapi.com/humeai/
```

## Authentication

LowCodeAPI handles authentication automatically using API key credentials.

**Auth Type**: API Key

## Common Endpoints

### Category: Chat

#### Create Chat Completion

**Method**: `POST` | **LowCodeAPI Path**: `/v1/chat/completions`

**Full URL**:
```
https://api.lowcodeapi.com/humeai/v1/chat/completions?api_token={api_token}
```

**Description**: Create empathic chat completions

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `messages` | array | Yes | Array of message objects |
| `model` | string | Yes | Model to use |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/humeai/v1/chat/completions?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "model": "empathic-llm"
  }'
```

---

## Usage Examples

### Example 1: Empathic Chat

```bash
# Create empathic response
# No ID required
curl -X POST "https://api.lowcodeapi.com/humeai/v1/chat/completions?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "I am feeling sad today"}
    ],
    "model": "empathic-llm"
  }'
```

## Complete Endpoint Reference

- **Official Documentation**: [https://hume.ai/docs](https://hume.ai/docs)