Generate an AI response based on conversation history.
Use /generate for direct ThinkFeel requests. Send a persona ID and full message history. The response returns the selected final reply and optional alternatives.
POST https://playground.curvelabs.org/api/v1/generate
Headers
Header
Type
Required
Description
Content-Type
string
Yes
Must be application/json
x-api-key
string
Conditional
API key for API-key billing
Authorization
string
Conditional
Alternative bearer format: Bearer YOUR_API_KEY_HERE
Body parameters
Parameter
Type
Required
Description
personaId
string
Yes
Persona UUID provided during onboarding
messages
array
Yes
Conversation messages to use as context
messages[].role
string
Yes
user, assistant, system, or developer
messages[].content
string or text array
Yes
Plain text, or an array of text parts shaped as { type: "text", text: string }
messages[].timestamp
number or string
No
Optional timestamp; createdAt and created_at are also accepted
includeVariations
boolean
No
Return alternative reply choices. Defaults to false
messages[] must contain at least one message. Use user for the final user turn; assistant cannot be the last message.
system and developer messages are accepted as text-only context and should be placed before the final user turn. The
final user message must have non-empty content. Only text content is supported.
When includeVariations is true, the API may include replyChoices.
{ "status": "success", "result": { "finalReply": "hey! what's up?", "chunks": ["hey! what's up?"], "replyChoices": ["hey! what's up?", "hi there! how's it going?", "hey! good to hear from you"] }}
API-key /generate responses may also include a top-level rateLimits array when rate-limit metadata is available for your account.
SDK and CLI notes
The ThinkFeel SDK wraps /api/v1/generate and /api/v1/personify. It does not wrap /api/v1/completions, which remains
the OpenAI-compatible endpoint.
The ThinkFeel SDK package is currently 0.1.6 and supports:
new ThinkFeel({ apiKey, personaId, baseUrl? })
generate({ messages, includeVariations? })
personify({ raw })
When setting SDK baseUrl, pass only the site origin, such as https://playground.curvelabs.org; the SDK appends /api/v1 internally.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Curve Labs","colors":{"primary":"#0097B2","light":"#00C9ED","dark":"#f028aa"},"logo":{"light":"https://mintcdn.com/curvelabs/BiyQ4TsT2qUFcIh1/images/curve-labs-logo-light.png?fit=max\u0026auto=format\u0026n=BiyQ4TsT2qUFcIh1\u0026q=85\u0026s=81ab938562fe1a1c67b368b1502027e3","dark":"https://mintcdn.com/curvelabs/BiyQ4TsT2qUFcIh1/images/curve-labs-logo-dark.png?fit=max\u0026auto=format\u0026n=BiyQ4TsT2qUFcIh1\u0026q=85\u0026s=179813701b39270be9ce87fe49e4a138"},"favicon":"https://mintcdn.com/curvelabs/BiyQ4TsT2qUFcIh1/favicon.ico?fit=max\u0026auto=format\u0026n=BiyQ4TsT2qUFcIh1\u0026q=85\u0026s=7d2d680b6a420896325991d7fa104d96","appearance":{"default":"light"},"navbar":{"links":[{"href":"https://curvelabs.org/privacy","label":"Privacy"},{"href":"https://curvelabs.org/terms","label":"Terms"},{"href":"https://curvelabs.org/support","label":"Support"}],"primary":{"type":"button","label":"Request access","href":"https://www.curvelabs.org/apply"}},"footer":{"socials":{"x":"https://x.com/curve_labs","github":"https://github.com/artificial-affect","linkedin":"https://www.linkedin.com/company/curve-labs"}},"seo":{"metatags":{"og:image":"https://docs.curvelabs.org/images/thinkfeel-opengraph.png","twitter:image":"https://docs.curvelabs.org/images/thinkfeel-opengraph.png","og:description":"Build emotionally intelligent AI replies with ThinkFeel custom personas and OpenAI-compatible endpoints.","twitter:description":"Build emotionally intelligent AI replies with ThinkFeel custom personas and OpenAI-compatible endpoints."}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://curvelabs.org"},{"anchor":"Playground","icon":"sparkles","href":"https://playground.curvelabs.org"},{"anchor":"NPM","icon":{"style":"brands","name":"npm"},"href":"https://www.npmjs.com/package/@curvelabs.org/thinkfeel"},{"anchor":"GitHub","icon":"github","href":"https://github.com/artificial-affect"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"curvelabs","hasAudioNarration":false,"actualSubdomain":"curvelabs","customDomains":["docs.curvelabs.org"],"gitSource":{"type":"github","owner":"artificial-affect","repo":"curve-labs-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af5f0e304140d5ce9d7810f","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Cookbooks","count":6},{"language":"default","tag":"ThinkFeel","count":5},{"language":"default","tag":"Operations","count":4},{"language":"default","tag":"API reference","count":3},{"language":"default","tag":"Concepts","count":3},{"language":"default","tag":"Impact studies","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/generate","slug":"/api-reference/generate","pageMetadata":{"title":"POST /generate","description":"Generate an AI response based on conversation history.","href":"/api-reference/generate"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Generate an AI response based on conversation history.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`/generate`}),` for direct ThinkFeel requests. Send a persona ID and full message history. The response returns the selected final reply and optional alternatives.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://playground.curvelabs.org/api/v1/generate`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Must be `,_jsx(_components.code,{children:`application/json`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`x-api-key`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Conditional`}),_jsx(_components.td,{children:`API key for API-key billing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Conditional`}),_jsxs(_components.td,{children:[`Alternative bearer format: `,_jsx(_components.code,{children:`Bearer YOUR_API_KEY_HERE`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`personaId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Persona UUID provided during onboarding`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messages`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Conversation messages to use as context`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messages[].role`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`user`}),`, `,_jsx(_components.code,{children:`assistant`}),`, `,_jsx(_components.code,{children:`system`}),`, or `,_jsx(_components.code,{children:`developer`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messages[].content`})}),_jsx(_components.td,{children:`string or text array`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Plain text, or an array of text parts shaped as `,_jsx(_components.code,{children:`{ type: \"text\", text: string }`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messages[].timestamp`})}),_jsx(_components.td,{children:`number or string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Optional timestamp; `,_jsx(_components.code,{children:`createdAt`}),` and `,_jsx(_components.code,{children:`created_at`}),` are also accepted`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`includeVariations`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Return alternative reply choices. Defaults to `,_jsx(_components.code,{children:`false`})]})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`messages[]`}),` must contain at least one message. Use `,_jsx(_components.code,{children:`user`}),` for the final user turn; `,_jsx(_components.code,{children:`assistant`}),` cannot be the last message.\n`,_jsx(_components.code,{children:`system`}),` and `,_jsx(_components.code,{children:`developer`}),` messages are accepted as text-only context and should be placed before the final user turn. The\nfinal user message must have non-empty content. Only text content is supported.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://playground.curvelabs.org/api/v1/generate`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_API_KEY_HERE\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"personaId\": \"YOUR_PERSONA_ID\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"messages\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"role\": \"user\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"content\": \"Hello!\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`default-response`,children:`Default response`}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`includeVariations`}),` is `,_jsx(_components.code,{children:`false`}),`, the API returns the final reply and chunks.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"finalReply\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hey! what's up?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"chunks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hey! what's up?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] } }`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-with-variations`,children:`Response with variations`}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`includeVariations`}),` is `,_jsx(_components.code,{children:`true`}),`, the API may include `,_jsx(_components.code,{children:`replyChoices`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"finalReply\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hey! what's up?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"chunks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hey! what's up?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"replyChoices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hey! what's up?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hi there! how's it going?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hey! good to hear from you\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`API-key `,_jsx(_components.code,{children:`/generate`}),` responses may also include a top-level `,_jsx(_components.code,{children:`rateLimits`}),` array when rate-limit metadata is available for your account.`]}),`\n`,_jsx(Heading,{level:`2`,id:`sdk-and-cli-notes`,children:`SDK and CLI notes`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The ThinkFeel SDK wraps `,_jsx(_components.code,{children:`/api/v1/generate`}),` and `,_jsx(_components.code,{children:`/api/v1/personify`}),`. It does not wrap `,_jsx(_components.code,{children:`/api/v1/completions`}),`, which remains\nthe OpenAI-compatible endpoint.`]})}),`\n`,_jsxs(_components.p,{children:[`The ThinkFeel SDK package is currently `,_jsx(_components.code,{children:`0.1.6`}),` and supports:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`new ThinkFeel({ apiKey, personaId, baseUrl? })`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`generate({ messages, includeVariations? })`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`personify({ raw })`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`When setting SDK `,_jsx(_components.code,{children:`baseUrl`}),`, pass only the site origin, such as `,_jsx(_components.code,{children:`https://playground.curvelabs.org`}),`; the SDK appends `,_jsx(_components.code,{children:`/api/v1`}),` internally.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"POST /generate","description":"Generate an AI response based on conversation history.","href":"/api-reference/generate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body parameters","slug":"body-parameters","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Default response","slug":"default-response","depth":2,"children":[]},{"title":"Response with variations","slug":"response-with-variations","depth":2,"children":[]},{"title":"SDK and CLI notes","slug":"sdk-and-cli-notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/curvelabs/568e669b7e234cc7/curve-labs-branding.js"],"subdomain":"curvelabs","siteName":"Curve Labs","title":"POST /generate - Curve Labs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T06:55:10.094Z","originalFileLocation":"api-reference/generate.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Generate an AI response based on conversation history.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Curve Labs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"POST /generate - Curve Labs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build emotionally intelligent AI replies with ThinkFeel custom personas and OpenAI-compatible endpoints.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Curve Labs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.curvelabs.org/api-reference/generate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.curvelabs.org/images/thinkfeel-opengraph.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"POST /generate - Curve Labs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build emotionally intelligent AI replies with ThinkFeel custom personas and OpenAI-compatible endpoints.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.curvelabs.org/images/thinkfeel-opengraph.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/curvelabs/xgnzuCvxnwBsxmhG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Curve Labs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0097B2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.curvelabs.org/api-reference/generate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/generate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.curvelabs.org/#organization\",\"name\":\"Curve Labs\",\"url\":\"https://docs.curvelabs.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/curvelabs/BiyQ4TsT2qUFcIh1/images/curve-labs-logo-light.png?fit=max\u0026auto=format\u0026n=BiyQ4TsT2qUFcIh1\u0026q=85\u0026s=81ab938562fe1a1c67b368b1502027e3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.curvelabs.org#website\",\"name\":\"Curve Labs\",\"url\":\"https://docs.curvelabs.org\",\"publisher\":{\"@id\":\"https://docs.curvelabs.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.curvelabs.org/api-reference/generate#webpage\",\"url\":\"https://docs.curvelabs.org/api-reference/generate\",\"name\":\"POST /generate\",\"description\":\"Generate an AI response based on conversation history.\",\"dateModified\":\"2026-11-04T06:55:10.094Z\",\"isPartOf\":{\"@id\":\"https://docs.curvelabs.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.curvelabs.org/api-reference/generate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.curvelabs.org/api-reference/generate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Curve Labs\",\"item\":\"https://docs.curvelabs.org\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"POST /generate\",\"item\":\"https://docs.curvelabs.org/api-reference/generate\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.curvelabs.org/api-reference/generate#article\",\"headline\":\"POST /generate\",\"name\":\"POST /generate\",\"description\":\"Generate an AI response based on conversation history.\",\"url\":\"https://docs.curvelabs.org/api-reference/generate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.curvelabs.org/api-reference/generate#webpage\"},\"image\":\"https://docs.curvelabs.org/images/thinkfeel-opengraph.png\",\"dateModified\":\"2026-11-04T06:55:10.094Z\",\"publisher\":{\"@id\":\"https://docs.curvelabs.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.curvelabs.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Curve Labs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Curve Labs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/generate.md","siteName":"Curve Labs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://curvelabs.org"},{"anchor":"Playground","icon":"sparkles","href":"https://playground.curvelabs.org"},{"anchor":"NPM","icon":{"style":"brands","name":"npm"},"href":"https://www.npmjs.com/package/@curvelabs.org/thinkfeel"},{"anchor":"GitHub","icon":"github","href":"https://github.com/artificial-affect"}]},"pages":[{"group":"ThinkFeel","pages":[{"title":"ThinkFeel Emotion AI API","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"CLI and agents","href":"/cli-agents"},{"title":"SDK examples","description":"Generate ThinkFeel replies from JavaScript, TypeScript, Python, Ruby, and Go REST clients.","href":"/sdk-examples"}]},{"group":"API reference","pages":[{"title":"POST /generate","href":"/api-reference/generate"},{"title":"POST /completions","description":"Use ThinkFeel through an OpenAI-compatible text completions endpoint.","href":"/api-reference/completions"},{"title":"POST /personify","href":"/api-reference/personify"}]},{"group":"Concepts","pages":[{"title":"Custom personas","href":"/concepts/personas"},{"title":"Use cases","href":"/use-cases"},{"title":"FAQ","href":"/faq"}]},{"group":"Impact studies","pages":[{"title":"Impact studies","href":"/impact-studies/index"},{"title":"AI video content: Unreel.ai","href":"/impact-studies/unreel"},{"title":"Agent workflows: Unbrowse.ai","href":"/impact-studies/unbrowse"}]},{"group":"Operations","pages":[{"title":"Error handling","href":"/operations/errors"},{"title":"Best practices","href":"/operations/best-practices"},{"title":"Rate limits","href":"/operations/rate-limits"},{"title":"Support and feedback","href":"/support"}]},{"group":"Cookbooks","pages":[{"title":"Cookbooks","href":"/cookbooks/index"},{"title":"Local SDK check","href":"/cookbooks/local-sdk-check"},{"title":"Next.js app cookbook","href":"/cookbooks/nextjs-chat"},{"title":"Cookbook API request examples","href":"/cookbooks/api-request-examples"},{"title":"Production checklist","href":"/cookbooks/production-checklist"},{"title":"Testing and migration","href":"/cookbooks/testing-migration"}]}]},"basePath":"","title":"POST /generate - Curve Labs","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}