Konektika AI | Dokumentasi API

API Reference

Integrasikan kekuatan AI Konektika ke dalam aplikasi Anda hanya dalam hitungan menit. Platform kami mendukung penuh standar OpenAI-Compatible API, sehingga Anda bisa menggunakan berbagai library dan SDK ekosistem OpenAI tanpa modifikasi kompleks.

Penting: Karakteristik Model Kimi Thinking Pro

Model utama kami, kimi-chat (Kimi Thinking Pro), dirancang khusus untuk melakukan penalaran dan analisis logika mendalam. Anda mungkin akan mendapati respons yang agak lambat atau jeda di awal percakapan. Hal ini sangat wajar karena model sedang memproses konteks dan "berpikir" secara komprehensif terlebih dahulu sebelum menyusun jawaban akhir yang akurat.

Autentikasi

Autentikasi dilakukan menggunakan HTTP Header standar Authorization: Bearer.

Header Format

Authorization: Bearer <YOUR_API_KEY>

API Key bersifat rahasia. Jangan pernah mempublikasikannya di sisi klien (frontend) atau repository publik.

Base URL & Model

Base URL endpoint

https://konektikacloud.com/v1

Model Name

kimi-chat

Contoh Penggunaan

Pilih bahasa pemograman atau platform integrasi di bawah ini.

curl https://konektikacloud.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kimi-chat",
    "messages": [
      {"role": "user", "content": "Hai Konektika, ceritakan sebuah lelucon pendek!"}
    ],
    "temperature": 0.7
  }'

Gunakan library resmi openai untuk Python.

from openai import OpenAI

client = OpenAI(
    base_url="https://konektikacloud.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="kimi-chat",
    messages=[
        {"role": "user", "content": "Hai Konektika, ceritakan sebuah lelucon pendek!"}
    ]
)

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

Gunakan package resmi openai via npm.

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://konektikacloud.com/v1',
  apiKey: 'YOUR_API_KEY',
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'kimi-chat',
    messages: [{ role: 'user', content: 'Hai Konektika, ceritakan sebuah lelucon pendek!' }],
  });

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

main();

Integrasi Native PHP menggunakan cURL.

<?php
$api_key = "YOUR_API_KEY";
$url = "https://konektikacloud.com/v1/chat/completions";

$data = [
    "model" => "kimi-chat",
    "messages" => [
        ["role" => "user", "content" => "Hai Konektika, ceritakan sebuah lelucon pendek!"]
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . $api_key
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'];
?>

Konektika dapat langsung dihubungkan (plug-and-play) ke LangChain menggunakan modul ChatOpenAI.

from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage

chat = ChatOpenAI(
    openai_api_base="https://konektikacloud.com/v1",
    openai_api_key="YOUR_API_KEY",
    model_name="kimi-chat",
    temperature=0.7
)

messages = [HumanMessage(content="Hai Konektika, ceritakan sebuah lelucon pendek!")]
response = chat.invoke(messages)

print(response.content)

Konfigurasi manual untuk ~/.openclaw/openclaw.json. Pastikan menggunakan "api": "openai-completions" dan "contextWindow": 128000 agar fitur Tool Calling (seperti Web Search) berjalan sempurna dan instruksi sistem tidak terpotong.

{
  "models": {
    "mode": "merge",
    "providers": {
      "custom-konektikacloud-com": {
        "baseUrl": "https://konektikacloud.com/v1",
        "apiKey": "GANTI_DENGAN_API_KEY_KONEKTIKA_ANDA",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-chat",
            "name": "kimi-chat (Custom Provider)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-konektikacloud-com/kimi-chat"
      },
      "models": {
        "custom-konektikacloud-com/kimi-chat": {
          "alias": "Kimi-Pro-2.5"
        }
      }
    }
  }
}

Panduan Troubleshooting

401 Unauthorized

Periksa kembali penulisan API Key pada header Authorization. Pastikan akun belum expired atau dinonaktifkan oleh Admin.

402 Payment Required

Kuota API Key Anda telah habis atau deposit akun komersil sudah nol. Silakan top-up kembali.

429 Too Many Requests

Anda melampaui batas request per menit (Rate Limit). Terapkan mekanisme backoff (sleep/delay) pada kode aplikasi Anda.

Connection Error / Timeout

Masalah koneksi jaringan lokal pemanggil. Gateway Konektika selalu aktif dengan Uptime tinggi berkat Failover otomatis.

Respon Model Kosong / Error API

Beberapa gambar resolusi tinggi mungkin ditolak oleh sistem penglihatan (vision). Gunakan teks standar untuk hasil paling stabil.

Jika Anda membutuhkan bantuan teknis lanjutan atau ingin melakukan top-up saldo, silakan hubungi tim kami di: konektikacloud@gmail.com