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

Catatan: @lunos/client 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.

Peringatan: Paket npm bisa tertinggal dari API produksi dan gagal pada endpoint atau opsi baru. Jika mengalami error, beralihlah ke SDK JavaScript OpenAI dengan baseURL: "https://api.lunos.tech/v1" dan API key Lunos Anda, atau gunakan HTTP mentah.

pnpm add @lunos/client

pip install openai

3. Konfigurasi Client

import { LunosClient } from "@lunos/client";

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

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

const response = await client.chat.createCompletion({
  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);

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?" }],
});

response = 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.