Elara API Documentation

Selamat datang di dokumentasi resmi Elara API Gateway. Gateway ini menyediakan antarmuka RESTful berkinerja tinggi yang kompatibel dengan format standar OpenAI, serta menyediakan akses langsung ke mesin multi-layer AI (Gemini, Qwen, Open Ecosystem, dan Elara Knowledge Base RAG).

Welcome to the official Elara API Gateway documentation. This gateway provides a high-performance RESTful interface fully compatible with the standard OpenAI specification, giving you direct access to our multi-layer monster engine (Google Gemini, Alibaba Qwen, Open Ecosystem, and the Elara Knowledge Base RAG system).

key AutentikasiAuthentication

Untuk mengakses endpoint publik pengembang, Anda harus menyertakan API Key yang valid pada header HTTP Authorization dengan skema Bearer. API Key pengembang menggunakan format berawalan elara-sk-.

To access developer endpoints, you must include a valid secret key in the HTTP Authorization header using the Bearer scheme. Official developer keys strictly follow the elara-sk- prefix format.

Authorization: Bearer elara-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

terminal Quickstart

Gunakan perintah cURL berikut untuk menguji panggilan pertama Anda ke endpoint completions yang kompatibel dengan SDK standar:

Use the following cURL command to verify your first completion request using OpenAI-standard format:

curl -X POST https://elara.rifqydev.my.id/api/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer elara-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "model": "automatic",
    "messages": [
      {
        "role": "system",
        "content": "Anda adalah asisten AI yang cerdas, sopan, dan solutif."
      },
      {
        "role": "user",
        "content": "Jelaskan konsep komputasi kuantum dalam dua kalimat ringkas."
      }
    ],
    "temperature": 0.7
  }'

api Endpoint OpenAI-CompatibleOpenAI-Compatible Endpoint

Endpoint pengembang utama yang dapat digunakan langsung dengan pustaka resmi OpenAI SDK (Python, Node.js, PHP, LangChain, AutoGen).

The primary developer endpoint natively compatible with official OpenAI SDK libraries (Python, Node.js, PHP, LangChain, AutoGen, and LlamaIndex).

Parameter Permintaan (Request Body)Request Parameters (Request Body)

Contoh Respon BerhasilSuccessful Response Example

{
  "id": "chatcmpl-1715426800000",
  "object": "chat.completion",
  "created": 1715426800,
  "model": "Gemini 3.5 Flash Lite",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Komputasi kuantum memanfaatkan fenomena mekanika kuantum seperti superposisi dan keterikatan untuk memproses data. Hal ini memungkinkan pemecahan kalkulasi rumit secara eksponensial lebih cepat dibandingkan komputer klasik."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 42,
    "total_tokens": 70
  }
}

toll Sistem Action Cost & Tingkatan KastaAction Cost System & Account Tiers

Elara API tidak menerapkan sistem biaya berbasis token-token mikro yang membingungkan. Setiap permintaan dihitung berdasarkan bobot komputasi (Action Cost) dari model yang digunakan:

Elara API eliminates unpredictable micro-token billing. Every request is calculated based on computational load (Action Cost) relative to the chosen model:

view_in_ar Katalog Lengkap Model AIComplete AI Models Catalog

Gunakan ID model berikut pada parameter model saat melakukan permintaan completions:

Use the exact model identifiers below in your model request body parameter:

perm_media Multimodal & Pemrosesan BerkasMultimodal & File Pipelines

Kirimkan foto, dokumen PDF, atau video dalam format Base64 secara langsung pada payload messages atau images:

Send images, PDF documents, or video frames encoded in Base64 directly within your messages or images payload:

{
  "model": "automatic",
  "message": "Ekstrak teks penting dari gambar ini dan terjemahkan ke Bahasa Indonesia.",
  "images": [
    {
      "name": "document.jpg",
      "mimeType": "image/jpeg",
      "base64": "/9j/4AAQSkZJRgABAQEAAAAAAAD/2wBD..."
    }
  ]
}

shield Sistem Anti-Crash Fallback Multi-LayerMulti-Layer Anti-Crash Fallback

Untuk memastikan ketersediaan layanan hingga 99.9%, gateway menerapkan rantai pengalihan instan tanpa interupsi:

To ensure 99.9% uptime, the gateway enforces transparent, zero-interruption fallback chains:

1. Primer: Mengakses model vendor yang dipilih (contoh: Alibaba Qwen / Open Ecosystem).Primary: Routes directly to the requested vendor (Alibaba Qwen / Open Ecosystem).
2. Sekunder: Jika terjadi timeout atau HTTP error 429/500, gateway secara transparan mengalihkan beban komputasi ke Google Gemini Native Engine.Secondary: If timeouts or 429/500 errors occur, traffic instantly routes to Google Gemini Native Engine.

integration_instructions Contoh Kode SDK LengkapComplete SDK Integration Examples

1. Python (Official OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="elara-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    base_url="https://elara.rifqydev.my.id/api/v1"
)

response = client.chat.completions.create(
    model="qwen3.8-max",
    messages=[
        {"role": "system", "content": "Kamu adalah asisten koding senior."},
        {"role": "user", "content": "Buatkan fungsi debounce di JavaScript modern."}
    ],
    temperature=0.5
)

print(response.choices[0].message.content)

2. Node.js (JavaScript Modern / Fetch)

async function askElara(prompt) {
  const response = await fetch("https://elara.rifqydev.my.id/api/v1/completions", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer elara-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    body: JSON.stringify({
      model: "automatic",
      messages: [
        { role: "user", content: prompt }
      ],
      temperature: 0.7
    })
  });

  const data = await response.json();
  if (!response.ok) {
    throw new Error(data.error || "Gagal memproses permintaan");
  }

  console.log(data.choices[0].message.content);
}

askElara("Rancang struktur folder proyek Next.js yang skalabel.");

3. PHP (cURL Native)

<?php
$apiKey = "elara-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx";
$url = "https://elara.rifqydev.my.id/api/v1/completions";

$data = [
    "model" => "nemotron_lightning",
    "messages" => [
        ["role" => "user", "content" => "Berikan saran tips keamanan REST API."]
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . $apiKey
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'];
?>

bug_report Kode Error & Panduan PenangananError Codes & Resolution Guide

Jika permintaan mengalami kegagalan, gateway mengembalikan format respon standar dengan kode status HTTP yang relevan:

When API requests fail, the gateway responds with standard HTTP error envelopes containing actionable diagnostics:

{
  "error": {
    "message": "Akses Ditolak: Model Dewa (Supernova) ini eksklusif untuk member Supernova! Silakan upgrade paket Anda.",
    "type": "permission_denied",
    "code": 403
  }
}