# CloudTalkAPI

**CloudtalkAPI** は、高性能な会話生成およびタスク処理を提供する API です。複数の AI モデルを活用して、自然な対話生成やタスクの実行が可能です。簡単な入力インターフェースを持ち、幅広いシナリオで活用できます。

***

#### **導入用途**

1. **カスタマーサポートの自動化**\
   サポートボットを通じて、顧客の質問に迅速かつ正確に応答します。
2. **コンテンツ生成の効率化**\
   ジョーク、物語、ブログ記事など、さまざまなコンテンツを自動生成します。
3. **教育アシスタント**\
   質問への回答や課題のサポートを行い、教育現場での利用をサポートします。
4. **会話型アプリケーションの構築**\
   人工知能を活用したチャットボットや仮想アシスタントを作成します。
5. **クリエイティブライティングの補助**\
   執筆支援やアイデアのブレインストーミングに役立ちます。

***

#### **Base URL**

```
https://cloudtalk-mixederapi.mixeder.com/
```

***

#### **Endpoints**

**POST /**

指定されたタスクを処理し、会話の生成または関連タスクの実行を行います。

**Headers**

| ヘッダー名          | 必須 | 説明                 |
| -------------- | -- | ------------------ |
| `Content-Type` | はい | `application/json` |

**Request Body**

| パラメーター名  | 必須  | 説明                                                         |
| -------- | --- | ---------------------------------------------------------- |
| `key`    | はい  | 使用する API キー                                                |
| `system` | いいえ | AI モデルに与えるシステムプロンプト（デフォルト: "You are a helpful assistant."） |
| `user`   | いいえ | ユーザーからの入力メッセージ（デフォルト: "Who won the world series in 2020?"） |

**Response**

* 成功時:\
  **HTTP Status**: 200\
  **Body**:

  ```json
  {
    "message": "API authentication, task processing, and billing completed successfully",
    "username": "user",
    "tasks": [
      {
        "inputs": {
          "messages": [
            {
              "role": "system",
              "content": "You are a helpful assistant."
            },
            {
              "role": "user",
              "content": "Who won the world series in 2020?"
            }
          ]
        },
        "response": {
          "response": "The Los Angeles Dodgers won the World Series in 2020, defeating the Tampa Bay Rays in six games (4-2). It was the Dodgers' first World Series title since 1988!"
        }
      }
    ],
    "billingResponse": "{\"status\":\"success\"}"
  }
  ```
* エラー時:\
  **HTTP Status**: 400 または 500\
  **Body**:

  ```json
  {
    "error": "Error message"
  }
  ```

***

#### **リクエストはすべてGETメゾットで行います。クエリ文字列に変数を代入してください。**


---

# 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://developer.mixeder.net/biz-ai/cloudtalkapi.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.