Character AI Chat API

Dokumentasi resmi Character AI Chat API dari Maelyn API untuk mengirim pesan ke Character AI dan menerima balasan beserta voice replay

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /ai/character/chat
  • Full URL: https://api.maelyn.eu/ai/character/chat
  • Method: POST
  • Credit Usage: 2

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk mengirim chat ke Character AI berdasarkan character id dan chat id, lalu mengembalikan balasan karakter beserta voice replay jika tersedia.

{
  "charid": "abcdefghijklmn123456",
  "chatid": "chat_1234567890",
  "query": "Halo, siapa nama kamu?"
}

Body Parameters

NameTypeRequiredDescription
charidstringYes*ID karakter yang ingin diajak chat
character_idstringYes*Alternatif dari charid
chatidstringYes*ID room/chat Character AI
chat_idstringYes*Alternatif dari chatid
querystringYes*Pesan utama yang dikirim ke karakter
textstringYes*Alternatif dari query
promptstringYes*Alternatif dari query

charid atau character_id wajib diisi. chatid atau chat_id wajib diisi. query, text, atau prompt wajib diisi.

Example Usage

{
  "charid": "abcdefghijklmn123456",
  "chatid": "chat_1234567890",
  "query": "Halo, siapa nama kamu?"
}

Success Response

{
  "success": true,
  "result": {
    "turn_key": {
      "turn_id": "9ef0b6da-3d68-4f71-bc1a-123456789abc",
      "chat_id": "chat_1234567890"
    },
    "author": {
      "name": "Character Name"
    },
    "candidates": [
      {
        "candidate_id": "9ef0b6da-3d68-4f71-bc1a-123456789abc",
        "raw_content": "Halo, aku adalah karaktermu. Senang bertemu denganmu!",
        "is_final": true
      }
    ],
    "primary_candidate_id": "9ef0b6da-3d68-4f71-bc1a-123456789abc",
    "voice": "https://example.com/replay/audio.mp3"
  }
}

Error Response

Invalid JSON

{
  "success": false,
  "error": "INVALID_JSON",
  "message": "Body request harus berupa JSON"
}

Character ID Required

{
  "success": false,
  "error": "CHARACTER_ID_REQUIRED",
  "message": "Field charid wajib diisi"
}

Chat ID Required

{
  "success": false,
  "error": "CHAT_ID_REQUIRED",
  "message": "Field chatid wajib diisi"
}

Query Required

{
  "success": false,
  "error": "QUERY_REQUIRED",
  "message": "Field query wajib diisi"
}

WebSocket Timeout

{
  "success": false,
  "error": "WEBSOCKET_TIMEOUT",
  "message": "Server Character AI terlalu lama merespon"
}

WebSocket Error

{
  "success": false,
  "error": "WEBSOCKET_ERROR",
  "message": "Terjadi gangguan pada koneksi Character AI"
}

Voice Replay Failed

{
  "success": false,
  "error": "REPLAY_REQUEST_FAILED",
  "message": "Gagal mengambil voice replay"
}

Internal Server Error

{
  "success": false,
  "error": "INTERNAL_SERVER_ERROR",
  "message": "Terjadi kesalahan pada sistem"
}

Playground