Apertus AI API

Dokumentasi resmi Apertus AI API dari Maelyn API untuk integrasi AI berbasis model Apertus 70B

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /ai/apertus
  • Full URL: https://api.maelyn.eu/ai/apertus
  • 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 prompt ke model Apertus AI.

{
  "query": "Halo, jelaskan apa itu JavaScript"
}

Body Parameters

NameTypeRequiredDescription
querystringYes*Prompt utama untuk AI
textstringYes*Alternatif dari query
promptstringYes*Alternatif dari query

Salah satu dari query, text, atau prompt wajib diisi.

Example Usage

{
  "query": "Halo, jelaskan apa itu JavaScript"
}

Success Response

{
  "success": true,
  "result": "JavaScript adalah bahasa pemrograman yang digunakan untuk membuat website menjadi interaktif.",
  "model": "swiss-ai/apertus-70b-instruct"
}

Error Response

Invalid JSON

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

Query Kosong

{
  "success": false,
  "error": "QUERY_REQUIRED",
  "message": "Field query wajib diisi",
  "example": {
    "query": "Halo, jelaskan apa itu JavaScript"
  }
}

AI Timeout

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

AI Error

{
  "success": false,
  "error": "UPSTREAM_HTTP_ERROR",
  "message": "Gagal mengambil respon dari server AI"
}

Internal Error

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

Playground