Dokumentasi API

Satu API key untuk semua model AI — OpenAI-compatible, bayar pakai credit.

Base URL

Endpoint OpenAI-compatible — ganti baseURL, langsung jalan.

https://rumahai.net/api/v1

Wajib gunakan prefix /api/v1 — endpoint lengkap:https://rumahai.net/api/v1/chat/completions

Authentication

Sertakan API key pada header Authorization untuk semua request.

HeaderAUTH

Authorization: Bearer sk-live-xxxxxxxxxxxxxxxxxxxxxxxx

Buat & kelola API key Anda di halaman API Keys. Kunci hanya ditampilkan satu kali saat dibuat.

GET

/models

Lihat semua model yang tersedia.

ResponseJSON

{
  "object": "list",
  "data": [
    { "id": "gpt-5.6-luna", "object": "model" },
    { "id": "claude-opus-4.8", "object": "model" }
  ]
}

POST

/chat/completions

Kirim percakapan, dapatkan respons AI.

Request bodyJSON

{
  "model": "gpt-5.6-luna",
  "messages": [
    { "role": "user", "content": "Halo" }
  ],
  "stream": false,      // opsional
  "temperature": 0.7    // opsional
}

Contoh Kode

Buat request ke API dengan bahasa favorit Anda.

cURL⌗

curl https://rumahai.net/api/v1/chat/completions \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      { "role": "user", "content": "Halo" }
    ]
  }'

JavaScriptJS

const res = await fetch("https://rumahai.net/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-live-xxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-5.6-luna",
    messages: [{ role: "user", content: "Halo" }],
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);

PythonPy

import requests

res = requests.post(
    "https://rumahai.net/api/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-live-xxxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-5.6-luna",
        "messages": [{"role": "user", "content": "Halo"}],
    },
)
print(res.json()["choices"][0]["message"]["content"])

PHPPHP

<?php
$res = curl_init("https://rumahai.net/api/v1/chat/completions");
curl_setopt_array($res, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer ***",
        "Content-Type: application/json",
    ],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        "model" => "gpt-5.6-luna",
        "messages" => [["role" => "user", "content" => "Halo"]],
    ]),
]);
$data = json_decode(curl_exec($res), true);
echo $data["choices"][0]["message"]["content"];

Node.jsOpenAI SDK

const OpenAI = require("openai");

const client = new OpenAI({
  baseURL: "https://rumahai.net/api/v1",
  apiKey: "sk-live-xxxx",
});

const completion = await client.chat.completions.create({
  model: "gpt-5.6-luna",
  messages: [{ role: "user", content: "Halo" }],
});
console.log(completion.choices[0].message.content);

Format Error

Semua error mengikuti standar OpenAI.

Response errorJSON

{
  "error": {
    "message": "Saldo credit tidak mencukupi",
    "type": "insufficient_balance",
    "code": "insufficient_balance"
  }
}

401invalid_api_keyAPI key tidak valid atau telah di-revoke

402insufficient_balanceSaldo credit tidak mencukupi

404model_not_foundModel tidak tersedia atau dinonaktifkan

429rate_limit_exceededTerlalu banyak request dalam 1 menit

400invalid_requestBody request tidak valid

502provider_unavailableProvider AI sedang tidak tersedia

500internal_errorKesalahan internal server

Siap untuk mulai membangun?

Daftar gratis, buat API key, dan mulai kirim request dalam hitungan menit.

Mulai Sekarang