ZAI AI API

Dokumentasi resmi ZAI AI API dari Maelyn API untuk integrasi model Z-AI melalui OpenAI-compatible Chat Completions API

Base Information

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

Endpoint ini digunakan untuk mengakses berbagai model AI dari Z-AI melalui format Chat Completions.

Authentication

Setiap request wajib menggunakan API key Maelyn melalui header berikut:

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

Contoh:

curl -X POST "https://api.maelyn.eu/api/ai/zai" \
  -H "Content-Type: application/json" \
  -H "x-maelyn-auth: YOUR_API_KEY" \
  -d '{
    "query": "Halo, apa kabar?"
  }'

Request Body

Request paling sederhana hanya membutuhkan parameter query.

{
  "query": "Jelaskan apa itu Artificial Intelligence"
}

Jika model tidak dikirim, API akan menggunakan model default:

x-preview-l

Contoh dengan model:

{
  "model": "glm-5.3",
  "query": "Jelaskan apa itu Artificial Intelligence"
}

Body Parameters

NameTypeRequiredDefaultDescription
querystringNo*-Input utama yang dikirim ke AI
textstringNo*-Alias untuk query
promptstringNo*-Alias untuk query
modelstringNox-preview-lID model Z-AI yang digunakan
  • Salah satu dari query, text, atau prompt wajib diisi.

Available Models

Berikut model yang tersedia pada ZAI AI API.

Display NameModel IDInputOutputDescription
GLM-5.3-Flashx-preview-lTextTextLightweight flagship model dengan kualitas premium dan response cepat
GLM-5.3glm-5.3TextTextFlagship model yang unggul dalam coding dan long-horizon tasks
GLM-5.2glm-5.2TextTextPrevious flagship model
GLM-5-TurboGLM-5-TurboTextTextModel untuk chat, coding, dan agentic tasks
GLM-5V-TurboGLM-5v-TurboTextTextVision model dengan kemampuan intelligence yang dikembangkan
GLM-4.7glm-4.7TextTextClassic high-performance model

Default Model

Jika client tidak mengirimkan parameter model, API secara otomatis menggunakan:

x-preview-l

Yang merupakan:

Display Name: GLM-5.3-Flash
Model ID: x-preview-l

Contoh:

{
  "query": "Apa itu machine learning?"
}

Setara dengan:

{
  "model": "x-preview-l",
  "query": "Apa itu machine learning?"
}

Chat

Basic Chat

Contoh request menggunakan model default:

{
  "query": "Halo, perkenalkan dirimu."
}

Chat dengan Model Tertentu

{
  "model": "glm-5.3",
  "query": "Jelaskan cara kerja REST API."
}

Menggunakan Alias text

{
  "text": "Apa itu JavaScript?"
}

Menggunakan Alias prompt

{
  "prompt": "Buatkan contoh kode JavaScript sederhana."
}

Ketiga format berikut memiliki fungsi yang sama:

{
  "query": "Halo"
}

{
  "text": "Halo"
}

{
  "prompt": "Halo"
}

Success Response

Response yang berhasil akan memiliki format:

{
  "success": true,
  "result": "Halo! Ada yang bisa saya bantu hari ini?",
  "model": "x-preview-l"
}

Response Fields

FieldTypeDescription
successbooleanMenunjukkan request berhasil
resultstringJawaban yang diberikan oleh model
modelstringModel ID yang digunakan

Model Selection

Client dapat menentukan model menggunakan Model ID.

Contoh:

{
  "model": "glm-5.3",
  "query": "Buatkan kode REST API menggunakan Node.js."
}

Response:

{
  "success": true,
  "result": "Berikut contoh REST API menggunakan Node.js...",
  "model": "glm-5.3"
}

API hanya menerima model yang terdapat pada daftar Available Models.

Error Responses

Invalid JSON

Terjadi ketika request body bukan JSON yang valid.

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

HTTP Status: 400

Query Required

Terjadi ketika client tidak mengirimkan query, text, atau prompt.

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

HTTP Status: 400

Invalid Model

Terjadi ketika parameter model bukan string atau kosong.

{
  "success": false,
  "error": "MODEL_INVALID",
  "message": "Field model harus berupa string",
  "available_models": [
    "x-preview-l",
    "glm-5.3",
    "glm-5.2",
    "GLM-5-Turbo",
    "GLM-5v-Turbo",
    "glm-4.7"
  ],
  "default_model": "x-preview-l"
}

HTTP Status: 400

Model Not Supported

Terjadi ketika Model ID tidak tersedia.

{
  "success": false,
  "error": "MODEL_NOT_SUPPORTED",
  "message": "Model \"unknown-model\" tidak tersedia",
  "model": "unknown-model",
  "available_models": [
    "x-preview-l",
    "glm-5.3",
    "glm-5.2",
    "GLM-5-Turbo",
    "GLM-5v-Turbo",
    "glm-4.7"
  ],
  "default_model": "x-preview-l"
}

HTTP Status: 400

Upstream HTTP Error

Terjadi ketika server AI upstream mengembalikan HTTP error.

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

HTTP Status: 502

Empty AI Response

Terjadi ketika server AI tidak mengembalikan jawaban.

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

HTTP Status: 502

Request Timeout

Terjadi ketika server AI terlalu lama memberikan response.

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

HTTP Status: 504

Fetch Failed

Terjadi ketika API gagal menghubungi server AI.

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

HTTP Status: 500

Internal Server Error

Terjadi ketika terdapat error yang tidak terduga pada sistem Maelyn API.

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

HTTP Status: 500

Complete Examples

Default Model

curl -X POST "https://api.maelyn.eu/api/ai/zai" \
  -H "Content-Type: application/json" \
  -H "x-maelyn-auth: YOUR_API_KEY" \
  -d '{
    "query": "Apa itu Artificial Intelligence?"
  }'

Model yang digunakan:

GLM-5.3-Flash
x-preview-l

GLM-5.3

curl -X POST "https://api.maelyn.eu/api/ai/zai" \
  -H "Content-Type: application/json" \
  -H "x-maelyn-auth: YOUR_API_KEY" \
  -d '{
    "model": "glm-5.3",
    "query": "Buatkan contoh REST API menggunakan Hono."
  }'

GLM-5.2

{
  "model": "glm-5.2",
  "query": "Jelaskan konsep asynchronous programming."
}

GLM-5-Turbo

{
  "model": "GLM-5-Turbo",
  "query": "Buatkan strategi untuk membangun AI agent."
}

GLM-5V-Turbo

{
  "model": "GLM-5v-Turbo",
  "query": "Jelaskan gambar ini."
}

Model GLM-5v-Turbo mendukung input text dan image pada architecture upstream.

GLM-4.7

{
  "model": "glm-4.7",
  "query": "Buatkan contoh aplikasi Node.js sederhana."
}

Playground