Dokumentasi

Base URL : https://api.kiosapi.id/v1
API Key  : kios_live_xxxxxxxxxxxx

curl https://api.kiosapi.id/v1/chat/completions \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-6",
    "messages": [{ "role": "user", "content": "Halo!" }]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.kiosapi.id/v1",
    api_key="kios_live_xxxx",
)

resp = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.kiosapi.id/v1",
  apiKey: "kios_live_xxxx",
});

const resp = await client.chat.completions.create({
  model: "meta/llama-3.1-8b",
  messages: [{ role: "user", content: "Halo!" }],
});
console.log(resp.choices[0].message.content);

stream = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[{"role": "user", "content": "Tulis puisi singkat"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

curl https://api.kiosapi.id/v1/images/generations \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/imagen-3",
    "prompt": "kucing oranye memakai topi koki, fotorealistik",
    "option": "standard",
    "n": 1
  }'

# Respons 200:
# { "created": ..., "model": "google/imagen-3",
#   "data": [{ "b64_json": "<base64>", "mime": "image/png" }],
#   "kiosapi": { "option": "standard", "count": 1, "cost_rupiah": 2000 } }

curl https://api.kiosapi.id/v1/videos/generations \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "ombak pantai saat matahari terbenam, sinematik",
    "option": "standard",
    "duration_seconds": 5
  }'

# Respons 202:
# { "job_id": "uuid", "status": "running",
#   "poll_url": "https://api.kiosapi.id/v1/jobs/uuid", "estimate_rupiah": 22500 }

curl https://api.kiosapi.id/v1/jobs/uuid \
  -H "Authorization: Bearer kios_live_xxxx"

# running:  { "status": "running" }
# selesai:  { "status": "succeeded", "video_url": "...", "expires_at": "...", "cost_rupiah": 22500 }
# gagal:    { "status": "failed", "error": "..." }
# (job musik mengembalikan "audio_url", bukan "video_url")

curl https://api.kiosapi.id/v1/music/generations \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/music-2.6",
    "prompt": "pop akustik Indonesia yang hangat, vokal wanita",
    "lyrics": "[Verse]\nPagi cerah di kota\n[Chorus]\nBersama kita bisa"
  }'

# Respons 202 → poll GET /v1/jobs/:id sampai:
# { "status": "succeeded", "audio_url": "...", "cost_rupiah": 6500 }

curl https://api.kiosapi.id/v1/audio/speech \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/speech-2.8-turbo",
    "input": "Selamat datang di Kiosapi!",
    "voice": "Indonesian_CalmWoman"
  }' --output suara.mp3

import base64, requests

res = requests.post(
    "https://api.kiosapi.id/v1/images/generations",
    headers={"Authorization": "Bearer kios_live_xxxx"},
    json={"model": "google/imagen-3", "prompt": "kucing oranye memakai topi koki",
          "option": "standard", "n": 1},
)
img = res.json()["data"][0]["b64_json"]
with open("out.png", "wb") as f:
    f.write(base64.b64decode(img))

const base = "https://api.kiosapi.id";
const headers = { Authorization: "Bearer kios_live_xxxx", "Content-Type": "application/json" };

// 1) submit job
const submit = await fetch(`${base}/v1/videos/generations`, {
  method: "POST", headers,
  body: JSON.stringify({ model: "alibaba/wan2.7-t2v", prompt: "ombak pantai saat senja",
                         option: "standard", duration_seconds: 5 }),
});
const { job_id } = await submit.json();

// 2) poll until done (~5s interval)
let job;
do {
  await new Promise((r) => setTimeout(r, 5000));
  job = await (await fetch(`${base}/v1/jobs/${job_id}`, { headers })).json();
} while (job.status === "running");

if (job.status === "succeeded") console.log(job.video_url);

curl https://api.kiosapi.id/v1/rerank \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "baai/bge-reranker-base",
    "query": "apa itu kucing?",
    "documents": [
      "Kucing adalah hewan mamalia berkaki empat.",
      "Mobil listrik semakin populer di Indonesia."
    ],
    "return_documents": true
  }'

# Respons 200:
# { "model": "baai/bge-reranker-base",
#   "results": [
#     { "index": 0, "relevance_score": 0.9998, "document": { "text": "Kucing adalah..." } },
#     { "index": 1, "relevance_score": 0.0000373, "document": { "text": "Mobil listrik..." } }
#   ] }

curl https://api.kiosapi.id/v1/embeddings \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "Selamat datang di Kiosapi!"
  }'

# Respons 200:
# { "object": "list", "model": "openai/text-embedding-3-small",
#   "data": [{ "object": "embedding", "index": 0, "embedding": [0.0123, -0.0456, ...] }],
#   "usage": { "prompt_tokens": 6, "total_tokens": 6 } }

curl -X POST https://api.kiosapi.id/v1/vector-indexes \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "artikel-saya"}'

# Respons 201:
# { "name": "artikel-saya", "dimension": 1536, "metric": "cosine",
#   "vector_count": 0, "created_at": "..." }

curl -X POST https://api.kiosapi.id/v1/vector-indexes/artikel-saya/vectors/upsert \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "vectors": [
      { "id": "artikel-1", "values": [0.0123, -0.0456, ...], "metadata": { "kategori": "berita" } }
    ]
  }'

# Respons 200: { "upserted_count": 1 }

curl -X POST https://api.kiosapi.id/v1/vector-indexes/artikel-saya/query \
  -H "Authorization: Bearer kios_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "vector": [0.0123, -0.0456, ...],
    "top_k": 5,
    "include_metadata": true
  }'

# Respons 200:
# { "matches": [{ "id": "artikel-1", "score": 0.87, "metadata": { "kategori": "berita" } }] }

curl -X POST https://api.kiosapi.id/v1/vector-indexes/artikel-saya/vectors/delete \
  -H "Authorization: Bearer kios_live_xxxx" -H "Content-Type: application/json" \
  -d '{"delete_all": true}'

curl -X DELETE https://api.kiosapi.id/v1/vector-indexes/artikel-saya \
  -H "Authorization: Bearer kios_live_xxxx"

// Ekstrak teks PDF di browser dengan pdfjs-dist, lalu POST sebagai text/plain
import * as pdfjs from 'pdfjs-dist';

pdfjs.GlobalWorkerOptions.workerSrc = new URL('pdfjs-dist/build/pdf.worker.min.mjs', import.meta.url).toString();

const pdf = await pdfjs.getDocument({ data: await file.arrayBuffer() }).promise;
let text = '';
for (let p = 1; p <= pdf.numPages; p++) {
  const content = await (await pdf.getPage(p)).getTextContent();
  text += content.items.map((i) => i.str).join(' ') + '\n';
}

const body = new FormData();
body.append('file', new Blob([text], { type: 'text/plain' }), 'dokumen.txt');
body.append('extracted_from', 'pdf'); // ditagih native/pdf-text, bukan OCR
await fetch('https://api.kiosapi.id/v1/documents', {
  method: 'POST',
  headers: { Authorization: 'Bearer kios_live_xxxx' },
  body,
});

Base URL (OpenAI)    : https://api.kiosapi.id/v1
Base URL (Anthropic) : https://api.kiosapi.id      (Claude Code)
Model                : mis. anthropic/claude-sonnet-4-6, deepseek/deepseek-v4-flash

export ANTHROPIC_BASE_URL=https://api.kiosapi.id
export ANTHROPIC_API_KEY=kios_live_xxxx
export ANTHROPIC_MODEL=anthropic/claude-sonnet-4-6
export ANTHROPIC_SMALL_FAST_MODEL=anthropic/claude-haiku-4-5
claude

model = "anthropic/claude-sonnet-4-6"
model_provider = "kiosapi"

[model_providers.kiosapi]
name = "Kiosapi"
base_url = "https://api.kiosapi.id/v1"
env_key = "KIOSAPI_API_KEY"
wire_api = "chat"

aider --openai-api-base https://api.kiosapi.id/v1 \
  --openai-api-key kios_live_xxxx \
  --model deepseek/deepseek-v4-flash

$ch = curl_init('https://api.kiosapi.id/v1/chat/completions');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer kios_live_xxxx',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'openai/gpt-4o',
    'messages' => [['role' => 'user', 'content' => 'Halo!']],
  ]),
]);
$res = json_decode(curl_exec($ch), true);
echo $res['choices'][0]['message']['content'];

cfg := openai.DefaultConfig("kios_live_xxxx")
cfg.BaseURL = "https://api.kiosapi.id/v1"
client := openai.NewClientWithConfig(cfg)

resp, _ := client.CreateChatCompletion(context.Background(), openai.ChatCompletionRequest{
    Model:    "openai/gpt-4o",
    Messages: []openai.ChatCompletionMessage{{Role: "user", Content: "Halo!"}},
})
fmt.Println(resp.Choices[0].Message.Content)

client = OpenAI::Client.new(
  access_token: "kios_live_xxxx",
  uri_base: "https://api.kiosapi.id/v1"
)
resp = client.chat(parameters: {
  model: "openai/gpt-4o",
  messages: [{ role: "user", content: "Halo!" }]
})
puts resp.dig("choices", 0, "message", "content")

var body = """
  {"model":"openai/gpt-4o","messages":[{"role":"user","content":"Halo!"}]}
  """;
var req = HttpRequest.newBuilder(URI.create("https://api.kiosapi.id/v1/chat/completions"))
  .header("Authorization", "Bearer kios_live_xxxx")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString(body)).build();
var res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer kios_live_xxxx");
var payload = new {
    model = "openai/gpt-4o",
    messages = new[] { new { role = "user", content = "Halo!" } }
};
var res = await http.PostAsJsonAsync(
    "https://api.kiosapi.id/v1/chat/completions", payload);
Console.WriteLine(await res.Content.ReadAsStringAsync());

# langsung (tanpa install)
npx kiosapi

# atau install global
npm i -g kiosapi
kiosapi

kiosapi masuk        # tempel kios_live_… (ditampilkan sebagai ****)
kiosapi periksa      # cek konektivitas, versi, & saldo
kiosapi --version    # tampilkan versi (alias: kiosapi versi / -v)
kiosapi perbarui     # update ke versi terbaru

# Linux/macOS : ~/.kiosapi/config.json
# Windows     : %USERPROFILE%\.kiosapi\config.json
{
  "apiKey": "kios_live_xxxxxxxxxxxx",
  "baseUrl": "https://api.kiosapi.id",
  "defaultModel": "anthropic/claude-sonnet-4-6"
}

# Atau via env (untuk CI/script)
export KIOSAPI_API_KEY=kios_live_xxxx
kiosapi tanya "halo"

# .kiosapi/config.json — semua kunci opsional
{
  "model": "deepseek/deepseek-v4-flash",
  "mode": "buat",
  "otomatis": false,
  "maxSteps": 60,
  "maxTokens": 80000,
  "projectContext": "REST API Express + TypeScript. Tes di src/__tests__/. Pakai Zod untuk validasi.",
  "tim": {
    "manajer":   "anthropic/claude-sonnet-4-6",
    "perencana": "anthropic/claude-sonnet-4-6",
    "koder":     "deepseek/deepseek-v4-pro",
    "peninjau":  "openai/gpt-4o-mini"
  },
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

$ kiosapi
buat › bikin endpoint GET /health di Express + tes Jest-nya
buat › @src/routes/auth.ts perbaiki error handler ini
buat › @git:diff ada yang perlu di-refactor?
buat › /commit                  # buat commit git
buat › /diff HEAD~1             # git diff dengan argumen opsional
buat › /shell npm test          # jalankan perintah shell langsung
buat › /model                   # picker model bernomor
buat › /mode rencana            # ganti mode agen
buat › /tim tambah auth JWT     # manajer pilih peran & jalankan
buat › /tim koder perbaiki bug  # jalankan satu peran langsung
buat › /budget 50000            # anggaran token/giliran (agen berhenti bila lewat)
buat › /undo                    # batalkan giliran terakhir (dari riwayat)
buat › /balik                   # kembalikan file yang diubah agen (git)
buat › /ringkas                 # ringkas riwayat (hemat token)
buat › /bantuan                 # daftar semua slash command

buat › @src/routes/auth.ts cek bug di fungsi ini
buat › @src/**/*.test.ts ada tes yang gagal?
buat › @git:diff          # git diff HEAD
buat › @git:status        # git status --short
buat › @git:log           # git log --oneline -10
buat › @git:staged        # git diff --staged

kiosapi tim "bikin endpoint GET /health + tes Jest"   # manajer yang memilih
kiosapi tim --peran koder "perbaiki bug di src/auth.ts"  # langsung ke koder

# model berbeda per peran (atau set di .kiosapi/config.json → "tim")
kiosapi tim "refactor modul auth + tes" \
  --perencana qwen/qwen3-30b \
  --koder     deepseek/deepseek-v4-pro \
  --peninjau  openai/gpt-4o-mini

kiosapi lanjut
# Sesi tim tersimpan ditemukan
#   Tugas    : bikin REST API penuh dengan auth + tes
#   Progress : 3/7 langkah selesai
#   Langkah selesai:
#     ✓ 1. Buat struktur folder + package.json
#     ✓ 2. Implementasi model User + migrasi DB
#     ✓ 3. Endpoint auth (register/login/refresh)
# Lanjutkan? [y/t/n]

# Buat skill di project (.kiosapi/skills/fix-tests.md)
kiosapi skill buat fix-tests

# Buat skill global (-g → ~/.kiosapi/skills/, tersedia di semua proyek)
kiosapi skill buat -g review-security

# Jalankan (argumen masuk ke $ARGUMENTS / {{1}})
kiosapi skill fix-tests
kiosapi skill fix-tests "src/auth/"

# Bawaan + dari sesi interaktif
kiosapi skill review        # tinjau git diff
buat › /skills
buat › /skill fix-tests src/auth/

---
description: Perbaiki semua tes yang gagal dan jalankan ulang
mode: buat              # rencana | edit | buat
# otomatis: true
# model: deepseek/deepseek-v4-flash
# tim: true             # jalankan lewat manajer multi-agen
# peran: koder          # atau satu peran langsung: perencana | koder | peninjau
---

Jalankan tes untuk {{1}} dan perbaiki yang gagal:
- Analisis pesan error  (pakai $ARGUMENTS atau {{1}} {{2}} untuk argumen)
- Perbaiki satu per satu sampai semua lulus
- Jalankan ulang untuk konfirmasi semua hijau

# Anggaran token per tugas — agen berhenti rapi bila terlewat (checkpoint tersimpan)
kiosapi buat --budget 80000 "refactor modul auth"
buat › /budget 50000

# Revert: kembalikan file yang diubah agen pada giliran terakhir (via git)
kiosapi balik        # tracked → HEAD, file baru dihapus (dengan konfirmasi)
buat › /balik

# Scaffold file config
kiosapi mcp init        # buat ~/.kiosapi/mcp.json

# Test koneksi + lihat tools tersedia
kiosapi mcp sambung

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx" }
    }
  }
}

kiosapi tanya "ringkas ini" < README.md
kiosapi buat --otomatis "tambah endpoint /health + tes"
kiosapi tanya -m deepseek/deepseek-v4-flash "jelaskan kode" < src/auth.ts
kiosapi gambar "logo kopi minimalis, flat design" -o logo.png