Create a realtime assistant session
Mints a short-lived client secret for the hands-free cooking assistant, so a client can open a realtime connection without ever holding a long-lived provider key. Scope it to a recipe with `recipeId`. The secret expires quickly — request one per session, at the moment the user starts talking, rather than caching it.
Mints a short-lived client secret for the hands-free cooking assistant,
so a client can open a realtime connection without ever holding a
long-lived provider key. Scope it to a recipe with recipeId.
The secret expires quickly — request one per session, at the moment the user starts talking, rather than caching it.
Authorization
bearerAuth A Clerk session JWT. Obtain one with a Clerk frontend SDK
(session.getToken()) or, for server-to-server use, with a Clerk
machine token. The token's sub claim is the Flambe user id that scopes
every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/ai/session" \ -H "Content-Type: application/json" \ -d '{}'{ "clientSecret": "string", "expiresAt": 0}API reference
Every public Flambe endpoint, generated from the OpenAPI spec and verified against the running server.
Embed a search query POST
Returns the embedding vector for a search string, using the same model that indexed the recipes. Use it to run your own semantic search over recipes you have synced locally — embedding the query client-side with a different model would not produce comparable distances.