v3.0.0

Dokumentasi API

Panduan lengkap integrasi layanan Alyachan API. Akses endpoint AI, media downloader, dan utilitas data dengan standar RESTful yang aman dan skalabel.

01 — Memulai

Pengaturan Akun

Akses ke endpoint API memerlukan akun yang terverifikasi. Kami menyediakan opsi pendaftaran yang fleksibel (Email, Google, Discord) untuk mempercepat proses integrasi Anda.

Manajemen Kunci API

Setelah masuk, navigasikan ke Dashboard Akun pada tab 'API KEY'. Kunci ini adalah kredensial rahasia aplikasi Anda.

◦ Untuk mengambil Kunci API Anda, silakan menekan tombol "Copy"

Jangan pernah membagikan API Key di kode sisi klien atau repositori publik.

◦ Untuk mengganti Kunci API Anda, silakan menekan tombol "Generate Key" dan setelah itu menekan tombol "Update Key"

Whitelist IP Paket Berlangganan

Fitur keamanan untuk membatasi akses Kunci API hanya dari alamat IP server yang didaftarkan, Anda harus mengatur IP sebelum menggunakan Kunci API Anda

IP Statis: Daftarkan IP server produksi secara manual.
Izinkan Semua: Centang opsi ini jika server menggunakan Dynamic IP (Tidak disarankan untuk produksi).

02 — Integrasi

Instalasi Library

SDK Resmi

npm install @alyachan/api

HTTP Generik

npm install axios

Contoh Penggunaan

Untuk mendapatkan / mencari endpoint, silakan ke halaman Referensi API

index.js (SDK)Direkomendasikan

const AlyaApi = require('@alyachan/api').default
const Api = AlyaApi('https://api.alyachan.dev/api', 'sk_prod_xxxxxxxx')

async function main() {
  try {
    const res = await Api.post('/ai/text2img', {
      'prompt': 'Cyberpunk city',
      'models': 'Japanese'
    })
    console.log(res)
  } catch (e) {
    console.error(e)
  }
}

request.js (Axios) POST

const axios = require('axios')

const config = {
  'method': 'POST',
  'url': 'https://api.alyachan.dev/api/ai/text2img',
  'headers': {
    'Authorization': 'Bearer sk_prod_xxxxxxxx',
    'Content-Type': 'application/json'
  },
  'data': { 'prompt': 'Cyberpunk city', 'models': 'Japanese' }
}

axios(config)
  .then(r => console.log(r.data))
  .catch(e => console.error(e))

Respons Standar

Kode	Arti	Deskripsi
200	OK	Request berhasil diproses.
400	Permintaan Buruk	Parameter input salah atau kurang.
401	Tidak Terotorisasi	API Key tidak valid atau belum dikirim.
429	Batas Kecepatan	Batas request harian terlampaui.