Panduan API
API ini memakai format yang sama dengan OpenAI. Aplikasi, pustaka, dan alat yang sudah mendukung OpenAI bisa langsung dipakai: cukup ganti base URL dan kunci API.
- Base URL
https://sumberai.web.id/v1- Autentikasi
- Header Authorization: Bearer KUNCI_API_ANDA
- Kunci API
- Buat di Dasbor, menu Kunci API. Simpan baik-baik dan jangan dibagikan.
- Contoh model
- deepseek-v4-flash · lihat semua model
Permintaan pertama
Terminal
curl https://sumberai.web.id/v1/chat/completions \
-H "Authorization: Bearer KUNCI_API_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Jelaskan API dalam satu kalimat."}]
}'
Python
# pip install openai
from openai import OpenAI
klien = OpenAI(
base_url="https://sumberai.web.id/v1",
api_key="KUNCI_API_ANDA",
)
r = klien.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "Jelaskan API dalam satu kalimat."}],
)
print(r.choices[0].message.content)
JavaScript (Node.js)
// npm install openai
import OpenAI from "openai";
const klien = new OpenAI({
baseURL: "https://sumberai.web.id/v1",
apiKey: process.env.KUNCI_API,
});
const r = await klien.chat.completions.create({
model: "deepseek-v4-flash",
messages: [{ role: "user", content: "Jelaskan API dalam satu kalimat." }],
});
console.log(r.choices[0].message.content);
PHP
<?php
$ch = curl_init("https://sumberai.web.id/v1/chat/completions");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer KUNCI_API_ANDA",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"model" => "deepseek-v4-flash",
"messages" => [["role" => "user", "content" => "Halo!"]],
]),
]);
$j = json_decode(curl_exec($ch), true);
echo $j["choices"][0]["message"]["content"];
Jawaban bertahap (streaming)
Tambahkan "stream": true untuk menerima teks sedikit demi sedikit, seperti mengetik.
Terminal
curl https://sumberai.web.id/v1/chat/completions \
-H "Authorization: Bearer KUNCI_API_ANDA" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4-flash", "stream": true,
"messages": [{"role": "user", "content": "Tulis puisi pendek."}]}'
Membuat gambar
Terminal
curl https://sumberai.web.id/v1/images/generations \
-H "Authorization: Bearer KUNCI_API_ANDA" \
-H "Content-Type: application/json" \
-d '{"model": "bwr-image", "prompt": "kucing oranye membaca buku, gaya cat air", "size": "1024x1024"}'
Daftar model lewat API
Terminal
curl https://sumberai.web.id/v1/models \ -H "Authorization: Bearer KUNCI_API_ANDA"
Aplikasi siap pakai
Di aplikasi yang punya pilihan "OpenAI compatible" atau "Custom OpenAI" (misalnya editor kode, bot obrolan, atau plugin), isi:
- Base URL / API Host: https://sumberai.web.id/v1
- API Key: kunci dari dasbor Anda
- Model: salah satu nama di halaman Model
Kode galat yang sering muncul
- 401
- Kunci API salah, dicabut, atau tidak dikirim.
- 402
- Saldo token habis atau batas kunci tercapai. Beli paket atau naikkan batas kunci.
- 404
- Nama model tidak dikenal. Periksa ejaan di halaman Model.
- 429
- Terlalu banyak permintaan sekaligus. Tunggu sebentar lalu ulangi.