System One

Ajukan pertanyaan bertipe tentang sebuah teks atau data, dan terima satu jawaban bertipe untuk setiap pertanyaan. Model System One adalah model keputusan, bukan model chat. Karena request-nya bukan request chat, ini adalah kontrak kenari sendiri dan tidak ada method SDK OpenAI atau Anthropic yang memetakannya.

POST /v1/systemone

Endpoint ini hanya melayani model System One. Kalau dipanggil dengan model chat, hasilnya 400. Kalau endpoint chat dipanggil dengan id System One, hasilnya 400 yang mengarah ke sini. Lihat model System One yang sedang tersedia lewat panggilan publik yang tidak butuh key:

curl "https://kenari.id/v1/models?modality=systemone"

GET /v1/models tanpa parameter tidak menampilkan model embedding, rerank, moderasi, atau System One. Endpoint ini menampilkan model chat, gambar, suara, transkripsi, dan video. Contoh di bawah memakai jev-1-13-free, yaitu model gratis. Ganti dengan id mana pun yang dikembalikan panggilan di atas. Tidak ada streaming.

Request

Field	Tipe	Wajib	Keterangan
`model`	string	ya	Id model System One.
`state`	string, object, atau array	ya	Teks atau data yang dinilai.
`questions`	object	ya	Satu atau lebih pertanyaan. Setiap key adalah id pertanyaan pilihanmu, dan jawabannya kembali dengan key yang sama. Maksimum 128 pertanyaan.

Seluruh body request maksimum 512 KiB. Setiap pertanyaan adalah objek:

Field	Tipe	Wajib	Keterangan
`type`	string	ya	`noul`, `choice`, atau `score`.
`instructions`	string, object, atau array	ya	Isi pertanyaan.
`criteria`	object atau array	tidak	Untuk `noul`, deskripsi benar dan salah. Untuk `choice`, peta pilihan. Untuk `score`, rubrik berurutan.

Response

Response hanya berisi model, answers, dan usage. model adalah id versi yang menjawab, misalnya jev-1.13.0, dan kembali ke id yang kamu minta kalau id versinya tidak tersedia. answers berisi satu entri per id pertanyaan. usage melaporkan input_tokens dan output_tokens.

{
  "model": "jev-1.13.0",
  "answers": {
    "q": { "type": "noul", "noul": 0.91 }
  },
  "usage": { "input_tokens": 12, "output_tokens": 20 }
}

Contoh

curl

curl https://kenari.id/v1/systemone \
  -H "Authorization: Bearer $KENARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1-13-free",
    "state": "kucing duduk di atas karpet",
    "questions": {
      "q": {
        "type": "noul",
        "instructions": "Apakah ini kalimat tentang hewan?"
      }
    }
  }'

Python

Endpoint ini tidak punya method SDK, jadi pakai requests.

import os
import requests

resp = requests.post(
    "https://kenari.id/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['KENARI_API_KEY']}"},
    json={
        "model": "jev-1-13-free",
        "state": "kucing duduk di atas karpet",
        "questions": {
            "q": {
                "type": "noul",
                "instructions": "Apakah ini kalimat tentang hewan?",
            }
        },
    },
)
print(resp.json()["answers"])

JavaScript

const resp = await fetch("https://kenari.id/v1/systemone", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KENARI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "jev-1-13-free",
    state: "kucing duduk di atas karpet",
    questions: {
      q: {
        type: "noul",
        instructions: "Apakah ini kalimat tentang hewan?",
      },
    },
  }),
});
const { answers } = await resp.json();

Penagihan

System One ditagih per token input. Token output dilaporkan dan tidak ditagih. Model gratis seperti jev-1-13-free menagih Rp 0. Lihat Cara penagihan untuk cara estimasi, penahanan saldo, dan dimensi harga.

Error

Status	Kode	Kapan
400	`bad_request`	`model` tidak dikenal atau bukan model System One, `state` tidak ada atau bukan string, object, atau array, `questions` tidak ada, kosong, atau lebih dari 128 entri, sebuah pertanyaan punya `type` yang tidak dikenal atau tanpa `instructions`, atau body melewati 512 KiB.
400	`model_not_found`	Modelnya terdaftar tetapi saat ini tidak ada provider yang melayaninya. Coba lagi nanti.

Kode bersama, seperti all_providers_failed, ada di Error.