> For the complete documentation index, see [llms.txt](https://ultrasafe.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ultrasafe.gitbook.io/docs/api-documentation/eus1/conversational-ai.md).

# Conversational AI

<mark style="color:yellow;">`POST`</mark> •••••••/us/eus1/conversational/v1/chat/completions

**Headers**

| Name  | Value     |
| ----- | --------- |
| Key   | x-api-key |
| Value | \<value>  |

**Body** raw (json)

```json
{
    "model": "eus1",
    "messages": [
        {
            "role": "user", "content": "Hello"
        }
    ],
    "temperature":0.7,
    "stream": false,
    "max_tokens": 512
}
```

**Example Request**

```json
curl --location 'https://api.us.inc/us/eus1/conversational/v1/chat/completions' \
--data '{
    "model": "eus1",
    "messages": [
        {
            "role": "user", "content": "Hello"
        },
        {
            "role": "assistant", "content": "Hello again! If you have any questions or need assistance with something, feel free to ask. I'\''m here to help!"
        },
        {
            "role": "user", "content": "How can you help users?"
        }
    ],
    "temperature":0.7,
    "stream": false,
    "max_tokens": 512
}'
```

**Example Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "id": "d8283328-651d-479c-8c02-c9b6220c4e6c",
  "object": "chat.completion",
  "created": 1722542950,
  "model": "eus1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "As EUS1, I can provide a wide range of assistance to users. Here are some examples of how I can help:\n\n### General Information and Answers\n- Provide information on various topics, including but not limited to science, technology, history, culture, and more.\n- Answer questions to the best of my knowledge based on my training data up to January 15, 2024.\n\n### Problem Solving and Advice\n- Offer advice and suggestions on how to approach problems or tasks.\n- Help with decision-making by providing pros and cons of different options.\n- Assist with brainstorming and idea generation.\n\n### Education and Learning\n- Explain complex concepts in simple terms.\n- Provide study tips and resources for learning new subjects.\n- Assist with language learning and translation.\n\n### Writing and Proofreading\n- Help with writing and proofreading tasks, including grammar, spelling, and punctuation checks.\n- Suggest alternative phrases or sentences to improve clarity and readability.\n- Assist with formatting and structuring written content.\n\n### Technical Support\n- Troubleshoot common technical issues with computers, software, and other devices.\n- Provide step-by-step instructions for using software applications and tools.\n- Offer advice on how to stay safe online and protect personal data.\n\n### Creative Tasks\n- Generate creative writing, such as poetry or short stories.\n- Assist with art and design ideas.\n- Provide suggestions for music and other creative projects.\n\n### Productivity and Organization\n- Help with time management and organization techniques.\n- Suggest tools and apps for improving productivity.\n- Assist with goal-setting and planning.\n\n### Other Tasks\n- Provide definitions and explanations of words and phrases.\n- Translate text from one language to another.\n- Summarize long pieces of text into concise, easily digestible versions.\n\nKeep in mind that my knowledge cutoff date is January 15, 2024, so I may not have the most up-to-date information on very recent events or developments. If there's something specific you'd like help with, feel free to ask!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 664,
    "total_tokens": 1087,
    "completion_tokens": 423
  }
}
```

{% endtab %}

{% tab title="Headers (9)" %}

|                             |                                                                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| X-Powered-By                | Express                                                                                                                                                   |
| Access-Control-Allow-Origin | \*                                                                                                                                                        |
| Content-Type                | application/json; charset=utf-8                                                                                                                           |
| Content-Length              | 2385                                                                                                                                                      |
| ETag                        | W/"951-HgtzKfsPXJ/sboZDCH5M62pIh04"                                                                                                                       |
| Set-Cookie                  | connect.sid=s%3AJ3BejzfdhrSEIEFd538leY5-bwL3yOOd.ks7OvF45fXY2MekD%2FV3aHyPSBUUgSpQQD1UJN%2FTfLgA; Path=/; Expires=Thu, 01 Aug 2024 20:15:16 GMT; HttpOnly |
| Date                        | Thu, 01 Aug 2024 20:09:16 GMT                                                                                                                             |
| Connection                  | keep-alive                                                                                                                                                |
| Keep-Alive                  | timeout=5                                                                                                                                                 |
| {% endtab %}                |                                                                                                                                                           |
| {% endtabs %}               |                                                                                                                                                           |