Giblang AI GIBLANG AI / Dokumentasi API v1
Masuk Akun
REST API & SDK Spesifikasi v1

Dokumentasi API Giblang AI

Giblang AI (Generative Intelligence for Building, Learning, Automation, Navigation & Guidance) menyediakan antarmuka pemrograman aplikasi berstandar industri yang sepenuhnya kompatibel dengan spesifikasi OpenAI Chat Completions. Anda dapat menghubungkan mesin inferensi Giblang AI langsung ke alat pengembangan seperti Cursor, VS Code, LangChain, LlamaIndex, maupun kode aplikasi Python dan Node.js.

Titik Akhir (Base URL)
https://giblang.eu.cc/api/v1

Catatan: Sistem juga mendukung rute alternatif tanpa prefiks /api di https://giblang.eu.cc/v1 untuk integrasi perkakas yang memerlukan path singkat.

Autentikasi (API Key)

Setiap permintaan ke API dilindungi oleh kunci rahasia (*API Key*) berawalan wr_. Kunci ini harus dikirimkan dalam header HTTP Authorization menggunakan skema **Bearer**.

Authorization: Bearer wr_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Cara Membuat API Key:
  1. Buka halaman chat resmi di giblang.eu.cc/chat-ai.
  2. Klik foto profil akun di sudut kiri bawah, lalu pilih menu **API Keys**.
  3. Klik tombol **Buat Kunci Baru**, tentukan nama label, dan salin token rahasia yang dihasilkan.

Tingkat Layanan & Kuota (Free Tier)

Setiap pengguna terdaftar secara default dialokasikan ke dalam paket **Free Tier** dengan batasan sebagai berikut:

Kuota Permintaan
250 Panggilan

Kuota akun paket Free Tier

Batas Kecepatan (Rate Limit)
60 RPM

Maksimal 60 request per menit

Konteks Token
8.192 Token

Kapasitas output maksimal per interaksi

Setiap respon HTTP dari peladen menyertakan header kuota transparan:

x-ratelimit-limit-requests: 250
x-ratelimit-remaining-requests: 249
x-giblang-tier: free

Model yang Tersedia

Model ID Spesialisasi Status
giblang-ai-core Model penalaran umum, refaktorisasi kode, dan percakapan teknis cepat (Rekomendasi). Produksi
giblang-ai-code Khusus arsitektur perangkat lunak, debugging kompleks, dan unit test. Produksi
giblang-ai-vision Analisis struktur diagram teknis dan inspeksi tangkapan layar antarmuka. Produksi
POST /api/v1/chat/completions

Membuat respon teks atau refaktorisasi kode berdasarkan riwayat pesan yang dikirimkan.

Parameter Request (JSON Body)

Parameter Tipe Wajib Keterangan
messages array Ya Daftar objek pesan percakapan berformat {"role": "user"|"system"|"assistant", "content": "..."}.
model string Opsional Nama model target. Default: giblang-ai-core.
stream boolean Opsional Jika true, mengalirkan respon menggunakan format Server-Sent Events (SSE). Default: false.
temperature number Opsional Tingkat kreativitas (rentang 0.0 hingga 2.0). Default: 0.7.
max_tokens integer Opsional Jumlah token maksimum hasil generasi (maksimal 8.192). Default: 8.192.

Contoh Respon (200 OK)

{
  "id": "chatcmpl-IDDOb0TQjQacsD8SavhJAekw",
  "object": "chat.completion",
  "created": 1794026116,
  "model": "giblang-ai-core",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Ini adalah respon terstruktur dari mesin inferensi Giblang AI."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 28,
    "total_tokens": 43
  },
  "system_fingerprint": "fp_giblang_ai_core"
}

Integrasi IDE (Cursor & VS Code Cline)

Anda dapat menggunakan Giblang AI sebagai asisten coding langsung di editor tanpa perlu kartu kredit atau akun pihak ketiga:

Konfigurasi Cursor IDE
  • 1. Buka Cursor Settings → Models.
  • 2. Aktifkan opsi OpenAI API Key.
  • 3. Masukkan API Key Anda (wr_...).
  • 4. Pada menu Base URL, klik override dan masukkan:
    https://giblang.eu.cc/api/v1
  • 5. Masukkan model giblang-ai-core pada daftar model aktif.
VS Code (Cline / Roo-Code)
  • 1. Buka ekstensi Cline di VS Code.
  • 2. Pilih provider OpenAI Compatible.
  • 3. Masukkan Base URL:
    https://giblang.eu.cc/api/v1
  • 4. Masukkan API Key Giblang AI Anda.
  • 5. Tentukan Model ID: giblang-ai-core.

Contoh Kode Lengkap

Python (OpenAI SDK) 
from openai import OpenAI

# Inisialisasi klien dengan Base URL Giblang AI
client = OpenAI(
    base_url="https://giblang.eu.cc/api/v1",
    api_key="wr_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
)

# Panggilan Non-Streaming
response = client.chat.completions.create(
    model="giblang-ai-core",
    messages=[
        {"role": "system", "content": "Kamu adalah asisten refaktorisasi kode."},
        {"role": "user", "content": "Tuliskan migration Laravel untuk tabel inventaris."}
    ]
)

print(response.choices[0].message.content)
Node.js / TypeScript 
import OpenAI from "openai";

const openai = new OpenAI({
    baseURL: "https://giblang.eu.cc/api/v1",
    apiKey: "wr_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
});

async function main() {
    const completion = await openai.chat.completions.create({
        model: "giblang-ai-core",
        messages: [{ role: "user", content: "Buatkan skema validasi FormRequest PHP 8.4" }]
    });

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

main();
cURL (Terminal) 
curl -X POST https://giblang.eu.cc/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer wr_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "model": "giblang-ai-core",
    "messages": [
      {"role": "user", "content": "Halo Giblang AI"}
    ]
  }'

Kode Status & Penanganan Error

Status HTTP Tipe Error Penyebab & Solusi
401 Unauthorized invalid_api_key API Key tidak disertakan, tidak valid, atau sudah dicabut. Pastikan header Authorization: Bearer wr_... valid.
429 Too Many Requests insufficient_quota Kuota 250 permintaan paket Free telah habis, atau batas kecepatan 60 RPM terlampaui.
400 Bad Request invalid_request_error Parameter permintaan tidak lengkap atau format JSON salah (misal: array messages kosong).
500 Server Error upstream_error Seluruh node komputasi inferensi sedang sibuk. Coba kembali beberapa detik lagi.