Groq AI API

Dokumentasi resmi Groq AI API dari Maelyn API untuk integrasi AI berbasis model Groq (LLaMA)

Base Information

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

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk berinteraksi dengan AI Groq menggunakan format chat.

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

Body Parameters

NameTypeRequiredDescription
modelstringNoModel AI yang digunakan (default: llama-3.3-70b-versatile)
systemstringNoSystem prompt (opsional)
messagesarrayNo*Format chat multi-turn
promptstringNo*Input teks sederhana
querystringNo*Alternatif dari prompt
textstringNo*Alternatif dari prompt

Salah satu dari messages atau (prompt / query / text) wajib diisi.

Example Usage

Simple Prompt

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

Custom System + Messages

{
  "model": "llama-3.3-70b-versatile",
  "system": "Kamu adalah guru teknologi",
  "messages": [
    { "role": "user", "content": "Apa itu AI?" }
  ]
}

Success Response

{
  "success": true,
  "model": "llama-3.3-70b-versatile",
  "result": "Artificial Intelligence adalah teknologi yang memungkinkan mesin meniru kecerdasan manusia.",
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 15,
    "total_tokens": 35
  }
}

Error Response

Invalid JSON

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

Prompt Required

{
  "success": false,
  "error": "PROMPT_REQUIRED",
  "message": "Field prompt atau messages wajib diisi"
}

Upstream Error

{
  "success": false,
  "error": "UPSTREAM_API_ERROR",
  "message": "Gagal mengambil respon dari Groq API"
}

Empty AI Response

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

Request Timeout

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

Fetch Failed

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

Internal Server Error

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

Playground