Guía de la API de recuperación de conocimiento

Endpoint de la solicitud

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

Solicitar la lista de modelos disponibles

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

Encabezados de la solicitud

Encabezado	Valor	Descripción
Authorization	Bearer <your_token>	Token de autenticación para verificar la identidad del usuario. Reemplaza <your_token> con tu token real.
Content-Type	application/json	Indica que el cuerpo de la solicitud está en formato JSON.
Host	edge.flowith.net	Dirección del servidor de la API.
User-Agent	HTTPie	(Opcional) Identificador del cliente.

Cuerpo de la solicitud (JSON)

Parámetro	Tipo	Descripción
messages	Array	Lista de mensajes de la conversación. Cada objeto de mensaje contiene los campos role y content.
model	String	Nombre del modelo. Ejemplo: "gpt-4o-mini"
stream	Boolean	¿Habilitar respuesta en streaming? true para habilitar, false para deshabilitar.
kb_list	Array de String	Lista de ID de bases de conocimiento. Especifica el alcance de la recuperación de conocimiento.

Detalles del campo messages

• role: Rol del mensaje, puede ser "assistant" o "user".
• content: Contenido del mensaje, como consultas o instrucciones elaboradas.

Respuesta

Cuando stream es true (respuesta en streaming)

• Código de estado de la respuesta: 200 OK
• Encabezados de la respuesta: Incluye encabezados HTTP estándar como Content-Type: text/plain; charset=UTF-8, etc.
• Cuerpo de la respuesta: Un flujo de texto que comienza con data:. Cada bloque data: contiene un objeto JSON con los siguientes valores posibles de tag:
  • searching: Indica que la búsqueda está en curso; el campo content incluye actualizaciones del progreso.
  • seeds: Resultados intermedios de la búsqueda; content es un array JSON donde cada elemento es una pieza de conocimiento distinta que contiene id, tokens, content, order, source_id, source_title y nip.
  • final: Indica los resultados finales; content contiene el texto completo de la respuesta.

Cuando stream es false

• Código de estado de la respuesta: 200 OK
• Encabezados de la respuesta: Incluye encabezados HTTP estándar como Content-Type: application/json, etc.
• Cuerpo de la respuesta: Un objeto JSON que contiene los campos tag y content.
  • tag: Siempre "final".
  • content: Texto completo de la respuesta.

Ejemplos de curl

Respuesta 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>"]
  }' 

Respuesta sin 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>"]
  }' 

Recuerda reemplazar <your_token> y <knowledge_base_id> con tus valores reales.

Límites de tasa

• Solicitudes: 12 solicitudes por minuto (RPM)
• Nota: Exceder este límite producirá errores HTTP 429 (Too Many Requests)

Facturación

• Uso de cuota: Los cargos se calculan según la cuota de créditos (Credits) de la cuenta de Flowith correspondiente
• Ciclo de facturación: El uso se calcula y se deduce en tiempo real del saldo de tu cuenta