Dokumentasi API IOI AI

1. Mulai Cepat & Base URL

Gunakan endpoint produksi di bawah ini sebagai pengganti https://api.openai.com/v1 di aplikasi atau library SDK Anda.

2. Autentikasi

Setiap request ke endpoint gateway memerlukan API key yang diawali dengan ioi_live_. Anda dapat menyalin API key Anda langsung dari Dashboard Pengguna.

Sertakan key dalam header HTTP salah satu bentuk berikut:

Authorization: Bearer ioi_live_YOUR_API_KEY

Atau menggunakan header alternatif:

X-API-Key: ioi_live_YOUR_API_KEY

3. Daftar Model GET /v1/models

Mengambil daftar model AI aktif yang siap digunakan oleh akun Anda.

curl https://ai.ioi.my.id/v1/models \
  -H "Authorization: Bearer ioi_live_YOUR_API_KEY"

Contoh Model Populer Aktif:

• deepseek-v4.1 — Model penalaran dan coding dengan context 1 juta token.
• gcli/grok-4.7 — Model penalaran mutakhir dari xAI.
• gcli/grok-4.6 — Model performa tinggi dengan context 500k token.
• ag/gemini-3.8-flash-high — Model multimodal ultra-cepat dari Google.
• hy4-preview — Model preview efisien untuk tugas umum.

Daftar lengkap dan tombol salin 1-klik tersedia di Dashboard.

4. Chat Completions POST /v1/chat/completions

Kirim pesan obrolan dan dapatkan jawaban dari model AI pilihan Anda.

curl https://ai.ioi.my.id/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ioi_live_YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v4.1",
    "messages": [
      {"role": "user", "content": "Halo, tolong jelaskan apa itu REST API secara singkat."}
    ],
    "temperature": 0.7
  }'

5. Streaming Respons (Server-Sent Events)

Tambahkan parameter "stream": true untuk menerima output secara bertahap (karakter per karakter) seperti ChatGPT.

curl https://ai.ioi.my.id/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ioi_live_YOUR_API_KEY" \
  -N \
  -d '{
    "model": "gcli/grok-4.7",
    "messages": [{"role": "user", "content": "Tuliskan 1 pantun jenaka."}],
    "stream": true
  }'

6. Contoh Kode Siap Pakai

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.ioi.my.id/v1",
    api_key="ioi_live_YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="deepseek-v4.1",
    messages=[
        {"role": "system", "content": "Anda adalah asisten AI yang ramah dan cerdas."},
        {"role": "user", "content": "Halo! Buatkan contoh fungsi async di Python."}
    ]
)

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

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://ai.ioi.my.id/v1',
  apiKey: 'ioi_live_YOUR_API_KEY',
});

async function main() {
  const completion = await client.chat.completions.create({
    model: 'gcli/grok-4.7',
    messages: [{ role: 'user', content: 'Halo dunia!' }],
  });

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

main();

7. Status Code & Penanganan Error