Panduan Memulai

Ikuti langkah-langkah berikut untuk berhasil mengirim request pertama Anda melalui Lunos. Panduan ini mengasumsikan bahwa Anda sudah familiar dengan menjalankan perintah shell atau terminal secara lokal.

Catatan: Anda wajib memiliki akun Lunos terlebih dahulu. Silakan Buat Akun jika belum, lalu buka halaman Dashboard.

Video: Integrasi dengan JavaScript dan Python

1. Membuat API Key

1. Buka halaman API Keys.
2. Klik tombol Buat Kunci API Baru.
3. Beri nama yang deskriptif (misalnya development-laptop).
4. Konfigurasikan batasan limit dan izin akses yang sesuai dengan kebutuhan environment Anda.
5. Salin key tersebut (hanya akan ditampilkan sekali) dan simpan dengan aman di password manager atau sistem manajemen rahasia lainnya.

Penting: API Key bersifat sangat rahasia. Jangan pernah melakukan commit ke Git atau membiarkannya terekspos di dalam kode frontend aplikasi Anda.

2. Menginstal SDK Lunos

JavaScript / TypeScript (Sangat Disarankan)

pnpm add @lunos/sdk

Python (Menggunakan SDK OpenAI)

pip install openai

Catatan: @lunos/sdk adalah SDK resmi kami untuk lingkungan TypeScript dan JavaScript. Sementara untuk Python dan bahasa pemrograman lainnya, Anda dapat menggunakan SDK OpenAI bawaan dengan mengubah base URL ke sistem Lunos, atau menggunakan HTTP request standar.

3. Konfigurasi Client

JavaScript / TypeScript

import Lunos from "@lunos/sdk";

const client = new Lunos({
  apiKey: process.env.LUNOS_API_KEY!,
  baseURL: "https://api.lunos.tech/v1",
  appId: "my-app-v1", // Opsional, berguna untuk analitik
});

Python

from openai import OpenAI

client = OpenAI(
    api_key="your_api_key_here",
    base_url="https://api.lunos.tech/v1",
    default_headers={"X-App-ID": "my-app-v1"},  # opsional
)

4. Melakukan Request Pertama

JavaScript / TypeScript

const response = await client.chat.completions.create({
  model: "openai/gpt-4o",
  messages: [
    {
      role: "user",
      content: "Write a short poem about artificial intelligence.",
    },
  ],
  max_tokens: 150,
  temperature: 0.7,
});

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

Python

response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[
        {"role": "user", "content": "Write a short poem about artificial intelligence."},
    ],
    max_tokens=150,
    temperature=0.7,
)

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

5. Lanjutkan Eksplorasi

• Referensi API — panduan detail seputar endpoint dan header.
• Daftar Model — cari ID model beserta rincian harganya.
• FAQ — berbagai pertanyaan yang sering diajukan.

6. Mengaktifkan Fitur Observability untuk Debugging (Opsional)

Anda bisa menambahkan parameter observability: true di dalam sebuah request completion saat Anda membutuhkan informasi yang lebih detail untuk keperluan debugging request tertentu.

const response = await client.chat.completions.create({
  model: "google/gemma-4-26b-a4b-it",
  observability: true,
  messages: [{ role: "user", content: "Can you jogging?" }],
});

Setelah mengeksekusinya, buka menu Dashboard → Logs, klik tombol Detail pada baris request tersebut. Anda akan melihat rincian data request, output, dan usage (penggunaan token) yang terstruktur dengan rapi.

---

Butuh Bantuan?

Silakan email kami di hello@lunos.tech atau baca halaman FAQ.