Bilgi Getirme API Kılavuzu

İstek Uç Noktası

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

Kullanılabilir Model Listesini İsteme

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

İstek Başlıkları

Başlık	Değer	Açıklama
Authorization	Bearer <your_token>	Kullanıcı kimliğini doğrulamak için kimlik doğrulama belirteci. <your_token> yerine gerçek belirtecinizi yazın.
Content-Type	application/json	İstek gövdesinin JSON biçiminde olduğunu belirtir.
Host	edge.flowith.net	API sunucu adresi.
User-Agent	HTTPie	(İsteğe bağlı) İstemci tanımlayıcısı.

İstek Gövdesi (JSON)

Parametre	Tür	Açıklama
messages	Array	Konuşma mesajı listesi. Her mesaj nesnesi role ve content alanlarını içerir.
model	String	Model adı. Örnek: "gpt-4o-mini"
stream	Boolean	Akış yanıtı etkinleştirilsin mi? Etkinleştirmek için true, devre dışı bırakmak için false.
kb_list	String Array	Bilgi tabanı kimliği listesi. Bilgi getirme kapsamını belirtir.

messages Alanı Ayrıntıları

• role: Mesaj rolü, "assistant" veya "user" olabilir.
• content: Karmaşık sorgular veya talimatlar gibi mesaj içeriği.

Yanıt

stream true Olduğunda (Akış Yanıtı)

• Yanıt Durum Kodu: 200 OK
• Yanıt Başlıkları: Content-Type: text/plain; charset=UTF-8 gibi standart HTTP başlıklarını içerir.
• Yanıt Gövdesi: data: ile başlayan metin akışı. Her data: bloğu, aşağıdaki olası tag değerlerine sahip bir JSON nesnesi içerir:
  • searching: Aramanın devam ettiğini belirtir, content alanı ilerleme güncellemelerini içerir.
  • seeds: Ara arama sonuçları, content her öğesi id, tokens, content, order, source_id, source_title ve nip içeren ayrı bir bilgi parçası olan bir JSON dizisidir.
  • final: Nihai sonuçları belirtir, content tam yanıt metnini içerir.

stream false Olduğunda

• Yanıt Durum Kodu: 200 OK
• Yanıt Başlıkları: Content-Type: application/json gibi standart HTTP başlıklarını içerir.
• Yanıt Gövdesi: tag ve content alanlarını içeren bir JSON nesnesi.
  • tag: Her zaman "final".
  • content: Tam yanıt metni.

curl Örnekleri

Akış Yanıtı (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>"]
  }' 

Akışsız Yanıt (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>"]
  }' 

<your_token> ve <knowledge_base_id> değerlerini gerçek değerlerinizle değiştirmeyi unutmayın.

Hız Sınırları

• İstekler: Dakikada 12 istek (RPM)
• Not: Bu sınırın aşılması HTTP 429 (Çok Fazla İstek) hatalarına neden olur

Faturalandırma

• Kota Kullanımı: Ücretler, ilgili Flowith hesabının Kredi kotasına göre hesaplanır
• Faturalandırma Döngüsü: Kullanım gerçek zamanlı olarak hesaplanır ve hesap bakiyenizden düşülür