Run an inference query (streaming SSE)
Runs a query and streams the answer as Server-Sent Events.
Saving. With model_id and no conversation_id, a new conversation is created and the
question and answer are saved to it; its ID is in the complete event. Pass that
conversation_id (with the same model_id) to continue the conversation. Without
model_id, conversation_id is null.
Stream format. Each event is an event: <type> line followed by a data: <JSON> line.
The whole answer arrives in a single message event, and the stream ends after the
complete event (there is no [DONE] marker). Lines starting with : (e.g. : keepalive)
are comments sent while waiting and should be ignored.
| Event | When | Data fields |
|---|---|---|
context | Knowledge-base chunks were used | type, context, chunks (chunk_id, document_title, score), conversation_id |
web_sources | Web search was used | type, sources (title, url, snippet, relevance_score), total_sources, conversation_id |
image_generation | An image was generated | type, content, image_url, blob_path, generation_id, generation_time_seconds |
reasoning | With model_id | type, path |
message | Always | type, content (the full answer) |
complete | Always, last | type, reasoning_path, context_chunks, total_tokens, processing_time_ms, finish_reason, conversation_id |
Authorizations
Static, non-expiring API key: Authorization: Bearer <FOURMINDS_API_KEY>.
Body
The question or instruction.
1One of your models, to answer from its knowledge base. Optional; without it, a default model answers.
x >= 1Continue an existing conversation. Requires model_id, and the conversation must belong to that model.
Omit to use the default engine (SYMI). constellations requires model_id.
constellations Add live web results to the answer. Only takes effect together with model_id.
Generate an image from the query. The image link is in the image_generation event.
Only these keys are allowed; any other key returns 400.
Show child attributes
Show child attributes
0 <= x <= 2Response
Server-Sent Events stream. See the event table above.
The response is of type string.