Generate AI-powered text responses using the Recoup chat system. This endpoint processes chat requests and returns generated text along with metadata about the generation process.
Your Recoup API key. Learn more.
Chat generation request
Request body for chat generation. Exactly one of 'prompt' or 'messages' must be provided.
Single text prompt for the assistant. Required if 'messages' is not provided.
Array of UIMessage objects for context. Required if 'prompt' is not provided.
The unique identifier of the artist (optional)
The AI model to use for text generation (optional)
"openai/gpt-5-mini"
Array of tool names to exclude from execution
["create_scheduled_actions"]UUID of the chat room. If not provided, one will be generated automatically.
Topic name for the new chat room (e.g., 'Pulse Feb 2'). Only applies when creating a new room - ignored if room already exists. To edit the topic of an existing room, use PATCH /api/chats.
Chat generated successfully
Response from the chat generation endpoint
Array of content parts from the AI model response
Optional reasoning or explanation for the response
Optional array of sources used for the response
The reason why the generation finished
"stop"
Token usage information
Additional response metadata