Character AI Create Room API

Dokumentasi resmi Character AI Create Room API dari Maelyn API untuk membuat room chat baru dengan karakter Character AI

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /ai/character/create/room
  • Full URL: https://api.maelyn.eu/ai/character/create/room
  • Method: POST
  • Credit Usage: 3

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk membuat room chat baru dengan karakter Character AI berdasarkan ID karakter.

{
  "charid": "abcdefghijklmn123456"
}

Body Parameters

NameTypeRequiredDescription
charidstringYes*ID karakter yang ingin dibuatkan room chat
character_idstringYes*Alternatif dari charid

Salah satu dari charid atau character_id wajib diisi.

Example Usage

{
  "charid": "abcdefghijklmn123456"
}

Success Response

{
  "success": true,
  "result": {
    "chat": {
      "chat_id": "9ef0b6da-3d68-4f71-bc1a-123456789abc",
      "creator_id": "254409954",
      "character_id": "abcdefghijklmn123456",
      "visibility": "VISIBILITY_PRIVATE",
      "type": "TYPE_ONE_ON_ONE"
    }
  }
}

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"
}

WebSocket Timeout

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

WebSocket Send Failed

{
  "success": false,
  "error": "WEBSOCKET_SEND_FAILED",
  "message": "Gagal mengirim permintaan create room"
}

Invalid WebSocket Response

{
  "success": false,
  "error": "INVALID_WS_RESPONSE",
  "message": "Respon dari Character AI tidak valid"
}

WebSocket Error

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

WebSocket Closed

{
  "success": false,
  "error": "WEBSOCKET_CLOSED",
  "message": "Koneksi Character AI terputus sebelum room berhasil dibuat"
}

Internal Server Error

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

Playground