Panduan API Pengambilan Pengetahuan

Endpoint Permintaan

POST /external/use/seek-knowledge/seek HTTP/1.1

Meminta Daftar Model yang Tersedia

GET /external/use/seek-knowledge/models HTTP/1.1

Header Permintaan

Header	Nilai	Deskripsi
Authorization	Bearer <your_token>	Token autentikasi untuk memverifikasi identitas pengguna. Ganti <your_token> dengan token Anda yang sebenarnya.
Content-Type	application/json	Menunjukkan isi permintaan dalam format JSON.
Host	edge.flowith.net	Alamat server API.
User-Agent	HTTPie	(Opsional) Pengidentifikasi klien.

Isi Permintaan (JSON)

Parameter	Tipe	Deskripsi
messages	Array	Daftar pesan percakapan. Setiap objek pesan berisi bidang role dan content.
model	String	Nama model. Contoh: "gpt-4o-mini"
stream	Boolean	Aktifkan respons streaming? true untuk mengaktifkan, false untuk menonaktifkan.
kb_list	String Array	Daftar ID basis pengetahuan. Menentukan cakupan untuk pengambilan pengetahuan.

Detail Bidang messages

• role: Peran pesan, dapat berupa "assistant" atau "user".
• content: Isi pesan, seperti kueri atau instruksi yang canggih.

Respons

Ketika stream bernilai true (Respons Streaming)

• Kode Status Respons: 200 OK
• Header Respons: Mencakup header HTTP standar seperti Content-Type: text/plain; charset=UTF-8, dll.
• Isi Respons: Aliran teks yang dimulai dengan data:. Setiap blok data: berisi objek JSON dengan kemungkinan nilai tag berikut:
  • searching: Menunjukkan pencarian sedang berlangsung, bidang content mencakup pembaruan progres.
  • seeds: Hasil pencarian sementara, content adalah array JSON yang setiap elemennya merupakan potongan pengetahuan tersendiri yang berisi id, tokens, content, order, source_id, source_title, dan nip.
  • final: Menunjukkan hasil akhir, content berisi teks respons lengkap.

Ketika stream bernilai false

• Kode Status Respons: 200 OK
• Header Respons: Mencakup header HTTP standar seperti Content-Type: application/json, dll.
• Isi Respons: Objek JSON yang berisi bidang tag dan content.
  • tag: Selalu "final".
  • content: Teks respons lengkap.

Contoh curl

Respons Streaming (stream = true)

curl -X POST "https://edge.flowith.net/external/use/knowledge-base/seek" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -H "Host: edge.flowith.net" \
  -d '{
    "messages": [
      {"role": "assistant", "content": "I'd like to explore effective social dynamics and interpersonal relationships"},
      {"role": "user", "content": "Share your best strategies for authentic connection and building rapport in professional settings"}
    ],
    "model": "gpt-4.1-mini",
    "stream": true,
    "kb_list": ["<knowledge_base_id>"]
  }' 

Respons Non-Streaming (stream = false)

curl -X POST "https://edge.flowith.net/external/use/knowledge-base/seek" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -H "Host: edge.flowith.net" \
  -d '{
    "messages": [
      {"role": "assistant", "content": "I'd like to explore effective social dynamics and interpersonal relationships"},
      {"role": "user", "content": "Share your best strategies for authentic connection and building rapport in professional settings"}
    ],
    "model": "gpt-4.1-mini",
    "stream": false,
    "kb_list": ["<knowledge_base_id>"]
  }' 

Ingatlah untuk mengganti <your_token> dan <knowledge_base_id> dengan nilai Anda yang sebenarnya.

Batas Laju (Rate Limits)

• Permintaan: 12 permintaan per menit (RPM)
• Catatan: Melampaui batas ini akan menghasilkan kesalahan HTTP 429 (Too Many Requests)

Penagihan

• Penggunaan Kuota: Biaya dihitung berdasarkan kuota Credits dari akun Flowith yang bersangkutan
• Siklus Penagihan: Penggunaan dihitung dan dipotong secara real-time dari saldo akun Anda