Panduan Pemasangan DataByte AI

1. 1

   1. Pilih cara bayar

   Request Based Plan

   Paket bulanan

   Bayar per bulan, dapat jatah request harian dan bulanan. Tagihan tidak berubah walaupun dipakai banyak.

   Cocok untuk ngoding tiap hari dan untuk Claude Code.

   Lihat paket →

   AI Gateway

   Isi saldo, bayar per pemakaian

   Tanpa biaya bulanan. Saldo terpotong sesuai panjang pertanyaan dan jawaban (token). Banyak pilihan model: Claude, DeepSeek, MiniMax, dan lainnya.

   Cocok untuk pemakaian sesekali atau butuh model tertentu.

   Lihat model & isi saldo →

   Masih ragu? Pilih saja salah satu: pilihan ini hanya mengubah contoh di halaman ini, dan bisa diganti kapan saja. Permintaan ke API baru berhasil setelah paket aktif atau saldo terisi.

2. 2

   2. Buat API key

   1. Buka Dashboard → API Keys.
   2. Klik Create key, beri nama (misalnya "Laptop"), lalu buat.
   3. Salin kuncinya (diawali sk-db-). Kunci hanya ditampilkan satu kali, jadi simpan di tempat aman.

   Tempel API key Anda di sini (opsional)

   Contoh di halaman ini langsung terisi kunci Anda, jadi tidak perlu mengganti sk-db-xxxx satu per satu. Kunci hanya ada di tab browser ini: tidak disimpan, tidak dikirim, dan hilang saat halaman ditutup.
3. 3

   3. Pilih aplikasi yang Anda pakai

   Claude CodeAgen coding di terminalOpenCodeAgen coding di terminal, open sourceCursorEditor kode dengan AIVS CodeLewat ekstensi gratis ContinueHermes AgentAgen AI di komputer AndaTypingMindAplikasi chat di browserBot TelegramTanpa coding, dijalankan DataByteKode sendiriPython, JavaScript, terminal

   Ada error? Lihat Masalah umum & solusi.

4. 4

   4. Opsional: tes API key dari terminal

   Buka PowerShell: tekan tombol Windows, ketik "PowerShell", lalu tekan Enter. Tidak perlu "Run as administrator". Jangan pakai Command Prompt (CMD), karena perintah di halaman ini ditulis untuk PowerShell.

   Lalu tempel perintah ini dan tekan Enter:

   WindowsmacOSLinuxPowerShell

   Salin

   $body = @{ model = "MiniMax-M3"; messages = @(@{ role = "user"; content = "Halo! Balas dengan satu kalimat saja." }) } | ConvertTo-Json -Depth 5
   $res = Invoke-RestMethod -Method Post -Uri "https://ai.databyte.co.id/v1/chat/completions" -Headers @{ Authorization = "Bearer sk-db-xxxx" } -ContentType "application/json; charset=utf-8" -Body $body
   $res.choices[0].message.content

   Berhasil kalau muncul satu kalimat balasan dari AI. Tes ini memakai 1 request dari jatah paket (atau sedikit saldo untuk AI Gateway).

1. 1

   1. Buka menu Agents di dashboard

   Buka Dashboard → Agents
2. 2

   2. Ambil Telegram User ID Anda

   Kirim pesan apa saja ke @userinfobot, lalu salin angka "Id" yang dibalas.

3. 3

   3. Buat bot dan salin Bot Token

   Buka @BotFather, kirim /newbot, ikuti pertanyaannya, lalu salin token yang diberikan.

4. 4

   4. Pilih model, isi kepribadian bot, lalu klik Deploy Agent

Saat memasang

$bin = "$env:USERPROFILE\.local\bin"
$p = [Environment]::GetEnvironmentVariable('PATH', 'User')
if (($p -split ';') -notcontains $bin) { [Environment]::SetEnvironmentVariable('PATH', "$p;$bin", 'User') }
Write-Host "Selesai. Tutup lalu buka lagi PowerShell."

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Pesan error dari API

Claude Code

$f = "$env:USERPROFILE\.claude.json"
try {
  if (Test-Path $f) { Copy-Item $f "$f.bak" -Force; $j = [IO.File]::ReadAllText($f) | ConvertFrom-Json -ErrorAction Stop } else { $j = New-Object PSObject }
  $j | Add-Member -NotePropertyName hasCompletedOnboarding -NotePropertyValue $true -Force -ErrorAction Stop
  [IO.File]::WriteAllText($f, ($j | ConvertTo-Json -Depth 100))
  Write-Host "Selesai. Buka ulang Claude Code."
} catch { Write-Host "Gagal, file tidak diubah: $_" }

1. 1

   1. Siapkan API key dan saldo

   Satu API key berlaku untuk semua endpoint. Teks bisa memakai jatah paket atau saldo; gambar, suara, dan video selalu memakai saldo AI Gateway.

2. 2

   2. Pilih model dari katalog

   GET /gateway/v1/models memberi tahu jenis tiap model lewat output_modality dan pilihan yang didukungnya lewat media_capabilities.

3. 3

   3. Kirim request ke endpoint sesuai jenis model

   Teks ke chat/completions atau messages, gambar ke images/generations, suara ke audio/speech, video ke videos. Model yang dikirim ke endpoint yang salah dijawab 400 beserta nama endpoint yang benar.

4. 4

   4. Saldo ditahan dulu, ditagih setelah hasil jadi

   Untuk media, sebagian saldo ditahan sebelum model dipanggil. Setelah hasil jadi, biaya akhirnya ditagih dan sisa tahanan dilepas. Request yang gagal tidak ditagih.

5. 5

   5. Simpan hasilnya di tempat Anda

   Tautan unduh berlaku 1 jam, dan file dihapus dari penyimpanan kami pada waktu expires_at. Tautan baru bisa diminta lewat GET /gateway/v1/generations/{id} selama file masih ada.

Daftar endpoint

Parameter body

Memilih potongan lewat header (opsional)

Model media yang aktif sekarang

Memuat katalog…

Ambil daftarnya dari terminal

$res = Invoke-RestMethod -Uri "https://ai.databyte.co.id/gateway/v1/models"
$res.data | Where-Object { $_.output_modality -ne "text" } | Select-Object id, output_modality, media_capabilities | ConvertTo-Json -Depth 5

Baca katalog saat aplikasi Anda mulai, jangan menanam ID model di kode: model bisa bertambah atau diganti.

Parameter body (JSON)

Contoh

$body = @'
{"model":"google/gemini-nano-banana-2.1","prompt":"Kucing oranye memakai kacamata bulat, ilustrasi datar, latar biru muda","n":1,"aspect_ratio":"1:1"}
'@
$res = Invoke-RestMethod -TimeoutSec 600 -Method Post -Uri "https://ai.databyte.co.id/gateway/v1/images/generations" -Headers @{ Authorization = "Bearer sk-db-xxxx" } -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
Invoke-WebRequest -UseBasicParsing -Uri $res.data[0].url -OutFile gambar.png
Write-Host "Tersimpan: gambar.png, biaya USD $($res.usage.cost_usd)"

from urllib.request import urlretrieve
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.databyte.co.id/gateway/v1",
    api_key="sk-db-xxxx",
    timeout=300,  # gambar bisa butuh 1-3 menit
    max_retries=0,  # request yang putus tetap ditagih: jangan diulang otomatis
)

result = client.images.generate(
    model="google/gemini-nano-banana-2.1",
    prompt="Kucing oranye memakai kacamata bulat, ilustrasi datar, latar biru muda",
    n=1,
    extra_body={"aspect_ratio": "1:1"},  # parameter di luar standar OpenAI
)
urlretrieve(result.data[0].url, "gambar.png")
print("Tersimpan: gambar.png")

import { writeFile } from "node:fs/promises";

const res = await fetch("https://ai.databyte.co.id/gateway/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-db-xxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"model":"google/gemini-nano-banana-2.1","prompt":"Kucing oranye memakai kacamata bulat, ilustrasi datar, latar biru muda","n":1,"aspect_ratio":"1:1"}),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);

const file = await fetch(json.data[0].url); // tanpa header Authorization
await writeFile("gambar.png", Buffer.from(await file.arrayBuffer()));
console.log("Tersimpan: gambar.png, biaya USD", json.usage.cost_usd);

Respons

{
  "id": "img_1f0c9c1e-7a52-4d0e-9a55-2b7d7f0f3c11",
  "created": 1715000000,
  "data": [
    {
      "url": "https://…/0.png?…"
    }
  ],
  "usage": {
    "images": 1,
    "cost_usd": 0.01,
    "cost_idr": 170
  }
}

Angka biaya di contoh hanya ilustrasi, bukan harga. Harga tiap model ada di dashboard.

• data[].url adalah tautan unduh yang berlaku 1 jam. Unduh tanpa header Authorization, lalu simpan filenya di tempat Anda.
• Dengan response_format: "b64_json", isi gambar ada di data[].b64_json. Bentuk ini juga dipakai kalau tautan gagal dibuat, jadi periksa kedua kolom.
• Biaya ada di usage.cost_usd dan header x-databyte-cost-usd. id dipakai untuk mengambil ulang hasil lewat riwayat.

Edit gambar dengan gambar acuan

Endpoint-nya sama. Tambahkan input_references berisi gambar yang ingin diubah atau dijadikan acuan gaya. Hanya untuk model yang menerima input gambar.

{
  "model": "google/gemini-nano-banana-2.1",
  "prompt": "Ganti latar menjadi pantai saat matahari terbenam",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/foto-produk.png"
      }
    }
  ]
}

Parameter body (JSON)

Contoh

$body = @'
{"model":"elevenlabs/eleven-v4-turbo","voice":"sarah","input":"Halo! Ini suara yang dibuat lewat DataByte AI Gateway.","response_format":"mp3"}
'@
Invoke-WebRequest -UseBasicParsing -OutFile halo.mp3 -TimeoutSec 600 -Method Post -Uri "https://ai.databyte.co.id/gateway/v1/audio/speech" -Headers @{ Authorization = "Bearer sk-db-xxxx" } -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
Write-Host "Tersimpan: halo.mp3"

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.databyte.co.id/gateway/v1",
    api_key="sk-db-xxxx",
    timeout=300,
    max_retries=0,  # request yang putus tetap ditagih: jangan diulang otomatis
)

speech = client.audio.speech.create(
    model="elevenlabs/eleven-v4-turbo",
    voice="sarah",
    input="Halo! Ini suara yang dibuat lewat DataByte AI Gateway.",
    response_format="mp3",
)
speech.write_to_file("halo.mp3")
print("Tersimpan: halo.mp3")

import { writeFile } from "node:fs/promises";

const res = await fetch("https://ai.databyte.co.id/gateway/v1/audio/speech", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-db-xxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"model":"elevenlabs/eleven-v4-turbo","voice":"sarah","input":"Halo! Ini suara yang dibuat lewat DataByte AI Gateway.","response_format":"mp3"}),
});
if (!res.ok) {
  const { error } = await res.json(); // saat gagal, isinya JSON, bukan audio
  throw new Error(`${error.code}: ${error.message}`);
}
await writeFile("halo.mp3", Buffer.from(await res.arrayBuffer()));
console.log("Tersimpan: halo.mp3, ID:", res.headers.get("x-databyte-generation-id"));

Respons

• Saat berhasil, body adalah file audio (Content-Type: audio/mpeg), bukan JSON. Saat gagal, body adalah JSON error. Periksa status HTTP sebelum menyimpan file.
• Header x-databyte-generation-id berisi ID hasil (tts_…). Biaya akhirnya dibaca beberapa detik kemudian lewat GET /gateway/v1/generations/{id}.
• Teks dihitung per karakter. Satu request maksimal sepanjang batas input di atas; teks yang lebih panjang dipecah per paragraf lalu file audionya disambung.

Mengatur ekspresi

Tulis tag di dalam teks, tepat sebelum bagian yang ingin diubah: [whispers], [slowly], [shouting], [excited]. Contoh: "[whispers] Ini rahasia. [excited] Tapi kabarnya bagus!". Dukungan tag bergantung model, jadi dengarkan hasilnya dulu.

Parameter (multipart/form-data)

Contoh

curl.exe https://ai.databyte.co.id/gateway/v1/audio/transcriptions `
  -H "Authorization: Bearer sk-db-xxxx" `
  -F "[email protected]" `
  -F "model=ID_MODEL_TRANSKRIPSI" `
  -F "language=id"

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.databyte.co.id/gateway/v1",
    api_key="sk-db-xxxx",
    timeout=900,
    max_retries=0,  # request yang putus tetap ditagih: jangan diulang otomatis
)

with open("rekaman.mp3", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="ID_MODEL_TRANSKRIPSI",
        file=audio,
        language="id",
    )
print(result.text)

Alternatif: body JSON

Kalau rekaman sudah ada di URL publik, atau klien Anda tidak bisa mengirim multipart, kirim JSON dengan input_audio.

{
  "model": "ID_MODEL_TRANSKRIPSI",
  "input_audio": {
    "url": "https://example.com/rekaman.mp3",
    "format": "mp3"
  },
  "language": "id"
}

Respons

{
  "id": "stt_6a1d3d0a-2f6b-4a57-8d1e-0c1a9a4c7b22",
  "text": "Selamat pagi, rapat hari ini dimulai pukul sembilan.",
  "usage": {
    "seconds": 42.5,
    "cost_usd": 0.01,
    "cost_idr": 170
  }
}

Angka biaya di contoh hanya ilustrasi, bukan harga. Harga tiap model ada di dashboard.

Parameter body (JSON)

Contoh lengkap: kirim, pantau, unduh

import time
import requests  # pip install requests

API = "https://ai.databyte.co.id/gateway/v1"
HEADERS = {"Authorization": "Bearer sk-db-xxxx"}

# 1. Kirim pekerjaan. Jawabannya 202 berisi ID, videonya belum jadi.
job = requests.post(
    f"{API}/videos",
    headers=HEADERS,
    timeout=90,
    json={"model": "ID_MODEL_VIDEO", "prompt": "Drone terbang pelan di atas sawah terasering saat matahari terbit", "duration": 5, "aspect_ratio": "16:9"},
)
job.raise_for_status()
video_id = job.json()["id"]

# 2. Tanya statusnya tiap 10 detik sampai selesai (bisa beberapa menit).
while True:
    status = requests.get(f"{API}/videos/{video_id}", headers=HEADERS, timeout=30)
    status.raise_for_status()
    video = status.json()
    if video["status"] in ("completed", "failed", "cancelled", "expired"):
        break
    time.sleep(10)

# 3. Unduh hasilnya. Tautan berlaku 1 jam dan dibuka tanpa header Authorization.
if video["status"] == "completed":
    with open("video.mp4", "wb") as f:
        f.write(requests.get(video["url"], timeout=300).content)
    print("Tersimpan: video.mp4, biaya USD", video["cost_usd"])
else:
    print("Gagal:", video["status"], video.get("error"))  # tidak ditagih

$res = Invoke-RestMethod -Uri "https://ai.databyte.co.id/gateway/v1/generations?modality=image&limit=5" -Headers @{ Authorization = "Bearer sk-db-xxxx" }
$res.data | Select-Object id, status, model, units, cost_usd, url

Satu hasil

{
  "id": "tts_9d2c7e44-1b0a-4f3e-8a6d-7c5b4a3e2f10",
  "object": "media.generation",
  "status": "completed",
  "model": "elevenlabs/eleven-v4-turbo",
  "modality": "speech",
  "created": 1715000000,
  "url": "https://…/0.mp3?…",
  "urls": [
    "https://…/0.mp3?…"
  ],
  "prompt": "Halo! Ini suara yang dibuat lewat DataByte AI Gateway.",
  "unit_type": "char",
  "units": 54,
  "hold_usd": null,
  "cost_usd": 0.01,
  "cost_idr": 170,
  "is_estimated": false,
  "error": null,
  "completed_at": 1715000004,
  "expires_at": 1715604800
}

Angka biaya di contoh hanya ilustrasi, bukan harga. Harga tiap model ada di dashboard.

Isi objek generation

{
  "error": {
    "message": "Saldo akun Anda tidak mencukupi untuk melakukan request ini.",
    "type": "insufficient_quota",
    "code": "insufficient_balance"
  }
}

Kapan boleh mengulang

• 429: kalau ada header Retry-After, tunggu sebanyak detik itu lalu ulangi; kalau tidak ada, tunggu beberapa detik. Ada batas jumlah gambar, suara, dan video per rentang waktu untuk tiap akun.
• 502, 503, 504: ulangi dengan jeda yang makin panjang (misalnya 2, 4, 8 detik), paling banyak 3 kali.
• 400, 401, 402, 403, 404: jangan diulang apa adanya. Perbaiki request, kunci, atau saldo dulu.
• 500: hasil mungkin sudah dibuat. Cek riwayat dulu, baru ulangi kalau memang tidak ada.
• Pasang batas waktu klien 5 menit untuk gambar dan suara, 15 menit untuk transkripsi, dan matikan percobaan ulang otomatis milik SDK. Kalau koneksi Anda putus di tengah jalan, hasil tetap dibuat dan ditagih. Cek GET /gateway/v1/generations sebelum mengirim ulang, supaya tidak membayar dua kali.

Kode yang layak diulang: api_key_rpm_exceeded, gateway_maintenance, media_rate_limited, rate_limit_exceeded, upstream_no_output, upstream_error, upstream_timeout.

Error umum (semua endpoint)

Error lain

Untuk masalah saat memasang aplikasi (Claude Code, Cursor, dan lainnya), lihat Masalah umum & solusi.

1. 1

   1. Pasang DataByte MCP (butuh Node.js)

   Salin

   npm install -g @databytesolutionid/databyte-mcp

2. 2

   2. Tambahkan ke konfigurasi MCP aplikasi Anda

   JSON

   Salin

   {
     "mcpServers": {
       "databyte": {
         "command": "databyte-mcp",
         "args": [
           "--api-key",
           "sk-db-xxxx"
         ]
       }
     }
   }