Apertus AI API

Dokumentasi resmi Apertus AI API dari Maelyn API untuk integrasi AI dengan berbagai model yang tersedia pada provider Apertus AI

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /ai/apertus
  • Method: POST
  • Credit Usage: 2

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk mengirim prompt ke model AI yang tersedia.

Parameter model bersifat opsional. Jika tidak diberikan, API akan menggunakan model default:

swiss-ai/apertus-70b-instruct

Contoh request sederhana:

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

Contoh dengan pemilihan model:

{
  "model": "swiss-ai/apertus-v1.5-70b-thinking",
  "query": "Jelaskan konsep asynchronous programming pada JavaScript"
}

Body Parameters

NameTypeRequiredDescription
querystringYes*Prompt utama untuk AI
textstringYes*Alternatif dari query
promptstringYes*Alternatif dari query
modelstringNoModel AI yang ingin digunakan

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

Jika model tidak diberikan, API akan menggunakan swiss-ai/apertus-70b-instruct.

Available Models

Berikut model yang saat ini tersedia pada endpoint Apertus AI:

ModelProvider
swiss-ai/apertus-8b-instructSwiss AI
aisingapore/Qwen-SEA-LION-v4-32B-ITAI Singapore
aisingapore/Gemma-SEA-LION-v4-27B-ITAI Singapore
speakleash/Bielik-11B-v3.0-InstructSpeakLeash
swiss-ai/apertus-v1.5-8b-thinkingSwiss AI
swiss-ai/apertus-v1.5-70b-thinkingSwiss AI
swiss-ai/apertus-v1.5-8bSwiss AI
swiss-ai/apertus-v1.5-70bSwiss AI
swiss-ai/apertus-70b-instructSwiss AI

Default Model

swiss-ai/apertus-70b-instruct

Model Selection

Client dapat memilih model yang tersedia melalui parameter model.

Contoh:

{
  "model": "swiss-ai/apertus-8b-instruct",
  "query": "Apa itu REST API?"
}

Contoh menggunakan model Qwen SEA-LION:

{
  "model": "aisingapore/Qwen-SEA-LION-v4-32B-IT",
  "query": "Jelaskan manfaat artificial intelligence"
}

Contoh menggunakan model Apertus 70B Thinking:

{
  "model": "swiss-ai/apertus-v1.5-70b-thinking",
  "query": "Analisis kelebihan dan kekurangan penggunaan JavaScript"
}

Example Usage

Menggunakan Model Default

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

Menggunakan Model Tertentu

{
  "model": "swiss-ai/apertus-v1.5-70b",
  "query": "Jelaskan apa itu machine learning"
}

Menggunakan prompt

{
  "model": "swiss-ai/apertus-8b-instruct",
  "prompt": "Buatkan contoh kode JavaScript sederhana"
}

Menggunakan text

{
  "model": "aisingapore/Gemma-SEA-LION-v4-27B-IT",
  "text": "Apa perbedaan AI dan machine learning?"
}

Success Response

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

Jika model tertentu digunakan, field model akan menunjukkan model yang digunakan:

{
  "success": true,
  "result": "Machine learning adalah cabang dari kecerdasan buatan...",
  "model": "swiss-ai/apertus-v1.5-70b"
}

Error Response

Invalid JSON

HTTP 400

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

Query Kosong

HTTP 400

{
  "success": false,
  "error": "QUERY_REQUIRED",
  "message": "Field query wajib diisi",
  "example": {
    "query": "Halo, jelaskan apa itu JavaScript",
    "model": "swiss-ai/apertus-70b-instruct"
  }
}

Model Invalid

HTTP 400

Terjadi ketika parameter model bukan berupa string atau nilainya kosong.

{
  "success": false,
  "error": "MODEL_INVALID",
  "message": "Field model harus berupa string",
  "available_models": [
    "swiss-ai/apertus-8b-instruct",
    "aisingapore/Qwen-SEA-LION-v4-32B-IT",
    "aisingapore/Gemma-SEA-LION-v4-27B-IT",
    "speakleash/Bielik-11B-v3.0-Instruct",
    "swiss-ai/apertus-v1.5-8b-thinking",
    "swiss-ai/apertus-v1.5-70b-thinking",
    "swiss-ai/apertus-v1.5-8b",
    "swiss-ai/apertus-v1.5-70b",
    "swiss-ai/apertus-70b-instruct"
  ],
  "default_model": "swiss-ai/apertus-70b-instruct"
}

Model Tidak Didukung

HTTP 400

{
  "success": false,
  "error": "MODEL_NOT_SUPPORTED",
  "message": "Model \"invalid-model\" tidak tersedia",
  "model": "invalid-model",
  "available_models": [
    "swiss-ai/apertus-8b-instruct",
    "aisingapore/Qwen-SEA-LION-v4-32B-IT",
    "aisingapore/Gemma-SEA-LION-v4-27B-IT",
    "speakleash/Bielik-11B-v3.0-Instruct",
    "swiss-ai/apertus-v1.5-8b-thinking",
    "swiss-ai/apertus-v1.5-70b-thinking",
    "swiss-ai/apertus-v1.5-8b",
    "swiss-ai/apertus-v1.5-70b",
    "swiss-ai/apertus-70b-instruct"
  ],
  "default_model": "swiss-ai/apertus-70b-instruct"
}

AI Timeout

HTTP 504

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

Upstream AI Error

HTTP 502

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

Empty AI Response

HTTP 502

{
  "success": false,
  "error": "EMPTY_AI_RESPONSE",
  "message": "Server AI tidak mengembalikan jawaban"
}

Fetch Failed

HTTP 500

{
  "success": false,
  "error": "FETCH_FAILED",
  "message": "Terjadi gangguan saat menghubungi server AI"
}

Internal Error

HTTP 500

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

Playground