Guide de l'API de récupération de connaissances

Point de terminaison de la requête

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

Demander la liste des modèles disponibles

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

En-têtes de la requête

En-tête	Valeur	Description
Authorization	Bearer <your_token>	Jeton d’authentification pour vérifier l’identité de l’utilisateur. Remplacez <your_token> par votre jeton réel.
Content-Type	application/json	Indique que le corps de la requête est au format JSON.
Host	edge.flowith.net	Adresse du serveur de l’API.
User-Agent	HTTPie	(Facultatif) Identifiant du client.

Corps de la requête (JSON)

Paramètre	Type	Description
messages	Array	Liste des messages de la conversation. Chaque objet message contient les champs role et content.
model	String	Nom du modèle. Exemple : "gpt-4o-mini"
stream	Boolean	Activer la réponse en streaming ? true pour activer, false pour désactiver.
kb_list	String Array	Liste des ID de bases de connaissances. Définit la portée de la récupération de connaissances.

Détails du champ messages

• role : rôle du message, peut être "assistant" ou "user".
• content : contenu du message, comme des requêtes ou instructions sophistiquées.

Réponse

Lorsque stream est true (réponse en streaming)

• Code de statut de la réponse : 200 OK
• En-têtes de la réponse : inclut des en-têtes HTTP standard tels que Content-Type: text/plain; charset=UTF-8, etc.
• Corps de la réponse : flux de texte commençant par data:. Chaque bloc data: contient un objet JSON avec les valeurs tag possibles suivantes :
  • searching : indique qu’une recherche est en cours, le champ content inclut les mises à jour de progression.
  • seeds : résultats de recherche intermédiaires, content est un tableau JSON où chaque élément est une connaissance distincte contenant id, tokens, content, order, source_id, source_title et nip.
  • final : indique les résultats finaux, content contient le texte de réponse complet.

Lorsque stream est false

• Code de statut de la réponse : 200 OK
• En-têtes de la réponse : inclut des en-têtes HTTP standard tels que Content-Type: application/json, etc.
• Corps de la réponse : un objet JSON contenant les champs tag et content.
  • tag : toujours "final".
  • content : texte de réponse complet.

Exemples curl

Réponse en 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>"]
  }' 

Réponse sans 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>"]
  }' 

N’oubliez pas de remplacer <your_token> et <knowledge_base_id> par vos valeurs réelles.

Limites de débit

• Requêtes : 12 requêtes par minute (RPM)
• Remarque : dépasser cette limite entraînera des erreurs HTTP 429 (Too Many Requests)

Facturation

• Utilisation du quota : les frais sont calculés en fonction du quota de Credits du compte Flowith correspondant
• Cycle de facturation : l’utilisation est calculée et déduite en temps réel du solde de votre compte