curl --location --request POST https://api.writer.com/v1/completions \ --header "Authorization: Bearer <token>" \ --header "Content-Type: application/json" \--data-raw '{"model":"palmyra-x5","prompt":"Write me a short SEO article about camping gear","max_tokens":150,"temperature":0.7,"top_p":0.9,"stop":["."],"best_of":1,"random_seed":42,"stream":false}'
import os
from writerai import Writer
client = Writer(
# This is the default and can be omitted
api_key=os.environ.get("WRITER_API_KEY"),
)
completion = client.completions.create(
model="palmyra-x5",
prompt="Write me a short SEO article about camping gear",
)
print(completion.choices)
import Writer from 'writer-sdk';
const client = new Writer({
apiKey: process.env['WRITER_API_KEY'], // This is the default and can be omitted
});
async function main() {
const completion = await client.completions.create({
model: 'palmyra-x5',
prompt: 'Write me a short SEO article about camping gear',
});
console.log(completion.choices);
}
main();
Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don’t require conversational context.
POST
/
v1
/
completions
cURL
curl --location --request POST https://api.writer.com/v1/completions \ --header "Authorization: Bearer <token>" \ --header "Content-Type: application/json" \--data-raw '{"model":"palmyra-x5","prompt":"Write me a short SEO article about camping gear","max_tokens":150,"temperature":0.7,"top_p":0.9,"stop":["."],"best_of":1,"random_seed":42,"stream":false}'
import os
from writerai import Writer
client = Writer(
# This is the default and can be omitted
api_key=os.environ.get("WRITER_API_KEY"),
)
completion = client.completions.create(
model="palmyra-x5",
prompt="Write me a short SEO article about camping gear",
)
print(completion.choices)
import Writer from 'writer-sdk';
const client = new Writer({
apiKey: process.env['WRITER_API_KEY'], // This is the default and can be omitted
});
async function main() {
const completion = await client.completions.create({
model: 'palmyra-x5',
prompt: 'Write me a short SEO article about camping gear',
});
console.log(completion.choices);
}
main();
Deprecation notice: Palmyra X4 (palmyra-x4) and Palmyra X5 (palmyra-x5) will be deprecated on December 14, 2026.Migration path: Use Palmyra X6 (palmyra-x6) instead. Palmyra X6 has a 1M token context window (Palmyra X4 is 128k). See pricing for cost details and the deprecation policy for more information.
The ID of the model to use for generating text. This can be a Palmyra model such as palmyra-x5 or palmyra-x4, or the ID of an external model configured for your organization.
Used to control the nucleus sampling, where only the most probable tokens with a cumulative probability of top_p are considered for sampling, providing a way to fine-tune the randomness of predictions.
Specifies stopping conditions for the model's output generation. This can be an array of strings or a single string that the model will look for as a signal to stop generating further tokens.
Specifies the number of completions to generate and return the best one. Useful for generating multiple outputs and choosing the best based on some criteria.
Determines whether the model's output should be streamed. If true, the output is generated and sent incrementally, which can be useful for real-time applications.
The identifier of the model that was used to generate the responses in the 'choices' array.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Writer AI Studio","colors":{"primary":"#BFCBFF","light":"#6985FF","dark":"#5551ff"},"logo":{"light":"https://mintcdn.com/writer/YZ72OUP7BQyK8p2G/logo/writer_logo_light.svg?fit=max\u0026auto=format\u0026n=YZ72OUP7BQyK8p2G\u0026q=85\u0026s=c9a784871f9b98724bb1eae947e745ed","dark":"https://mintcdn.com/writer/YZ72OUP7BQyK8p2G/logo/writer_logo_dark.svg?fit=max\u0026auto=format\u0026n=YZ72OUP7BQyK8p2G\u0026q=85\u0026s=9e22a34b91e20df881d68634a0042c1d"},"favicon":"https://mintcdn.com/writer/z-qGRP1BKyHYhEJN/images/icons/favicon.svg?fit=max\u0026auto=format\u0026n=z-qGRP1BKyHYhEJN\u0026q=85\u0026s=33356fdc372b2640b92c5546da07c9e0","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]}},"navbar":{"primary":{"type":"button","label":"Sign in","href":"https://app.writer.com/login"}},"footer":{"socials":{"x":"https://x.com/Get_Writer","github":"https://github.com/writer","linkedin":"https://www.linkedin.com/company/getwriter"}},"seo":{"metatags":{"description":"Writer AI Studio developer documentation - Build AI agents with APIs, SDKs, Agent Builder, and no-code tools. Integrate generative AI into your applications.","og:site_name":"Writer AI Studio Documentation","og:type":"website","twitter:card":"summary_large_image","twitter:site":"@Get_Writer"},"indexing":"all"},"integrations":{"gtm":{"tagId":"GTM-NXVXDK"},"segment":{"key":"o2ZzfP0pJxH4cihXBPrF4IlbGqmG34BA"}},"contextual":{"options":["copy","view","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"writer","hasAudioNarration":false,"actualSubdomain":"writer","customDomains":["dev.writer.com"],"gitSource":{"type":"github","owner":"writerinternal","repo":"docs","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4c1eae34cca49cc969e2b","collectionId":"95a2c848-ef11-45d4-91ec-a4d1045cf7fd","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4c1eae34cca49cc969e2b"},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4c1eae34cca49cc969e2b","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Home","count":98},{"language":"default","tag":"Writer Framework","count":71},{"language":"default","tag":"Component reference","count":45},{"language":"default","tag":"API Reference","count":32},{"language":"default","tag":"Connect to your data","count":31},{"language":"default","tag":"Available prebuilt connectors","count":27},{"language":"default","tag":"Content","count":17},{"language":"default","tag":"Legacy API Reference","count":16},{"language":"default","tag":"Getting started","count":14},{"language":"default","tag":"Input","count":13}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* devanagari */\n@font-face {\n font-family: 'Poppins';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/poppins/v24/pxiByp8kv8JHgFVrLGT9Z11lFc-K.woff2) format('woff2');\n unicode-range: U+0900-097F, U+1CD0-1CF4, U+1CF7-1CF9, U+200C-200D, U+20A8, U+20B9, U+20F0, U+25CC, U+A830-A839, U+A8E0-A8FF, U+11B00-11B0A;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Poppins';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/poppins/v24/pxiByp8kv8JHgFVrLGT9Z1JlFc-K.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Poppins';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/poppins/v24/pxiByp8kv8JHgFVrLGT9Z1xlFQ.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* devanagari */\n@font-face {\n font-family: 'Poppins';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/poppins/v24/pxiByp8kv8JHgFVrLEj6Z11lFc-K.woff2) format('woff2');\n unicode-range: U+0900-097F, U+1CD0-1CF4, U+1CF7-1CF9, U+200C-200D, U+20A8, U+20B9, U+20F0, U+25CC, U+A830-A839, U+A8E0-A8FF, U+11B00-11B0A;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Poppins';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/poppins/v24/pxiByp8kv8JHgFVrLEj6Z1JlFc-K.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Poppins';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/poppins/v24/pxiByp8kv8JHgFVrLEj6Z1xlFQ.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--purple-1:#5551FF;--purple-2:#4A46DA;--black:#000;--gray-1:#333}body{font-family:\"Graphik\",sans-serif;font-weight:400}body.bold{font-weight:600}h1,h2,h3{font-family:\"Poppins\",sans-serif}h1{font-weight:600!important}h2,h3{font-weight:500}img[src$=no-code],img[src$=quickstart]{border:1px solid #e4e7ed}img[src$=auth]{min-width:25%;width:35%;margin:auto}img[src$=auth-table]{min-width:25px;width:25px}.imageBorder,img[src$=framework]{border:1px solid #e4e7ed}.flex-none.min-w-full.text-sm.overflow-x-auto{background-color:#171b1a}.no-bullet li{list-style-type:none;font-size:small}.large-icon{width:60px;height:100%}.bg-primary\\/10{background-color:#bfcbff}.text-primary{color:#000}.dark .prompts{color:#828282}.dark .prompts,.papers,.prompts{font-family:'Roboto Mono',monospace}.prompts{color:#000}.papers{font-size:small;padding-left:20px;padding-right:20px;text-align:justify}td,th{padding:10px;text-align:left}.update table td,.update table th{word-break:break-word}.expandedImageContainer{padding:16px;border-radius:16px;background:#e9eef1;overflow:hidden;display:flex;justify-content:center}.expandedImageContainerInner{display:flex;align-items:flex-start;max-width:300px;max-height:210px}.expandedImageContainer img{max-height:210px}.components__table{table-layout:fixed;width:300px}.button-wrapper{margin-top:30px}.button{border:0;cursor:pointer;font-size:14px;font-weight:600;padding:8px 20px;position:relative;outline:0;transition:background-color .1s ease-in}.primary-button{background-color:var(--purple-1);border-radius:40px;color:#fff;display:inline-flex;align-items:center}.secondary-button{background-color:var(--black);border-radius:30px;color:#fff}.button--arrow{padding-right:40px}.componentFields td,.componentFields th{padding:8px;border:1px solid rgb(var(--gray-200))}.componentFields .desc{width:50ch}:is(.dark .componentFields td, .dark .componentFields th, .dark .blueprintFields td, .dark .blueprintFields th){border:1px solid rgb(var(--gray-800))}.blueprintFields td,.blueprintFields th{padding:8px;border:1px solid rgb(var(--gray-200));vertical-align:top}#topbar-cta-button{margin:0}#topbar-cta-button a,li[id=\"https://app.writer.com/login\"] a{display:inline-flex;align-items:center;background-color:var(--purple-1)!important;border-radius:9999px;padding:4px 14px;font-weight:600;font-size:14px;text-decoration:none;transition:background-color .2s ease;line-height:24px}#topbar-cta-button a span,li[id=\"https://app.writer.com/login\"] a div,li[id=\"https://app.writer.com/login\"] a span{color:#fff!important}#topbar-cta-button a:hover,li[id=\"https://app.writer.com/login\"] a:hover{background-color:var(--purple-2)!important}#topbar-cta-button svg{margin-left:4px;height:16px;width:16px}li[id=\"https://app.writer.com/login\"]{margin:0;max-width:100%;box-sizing:border-box}li[id=\"https://app.writer.com/login\"] a{display:inline-flex!important;align-items:center!important;border-radius:9999px!important;padding:4px 8px 4px 14px!important;font-weight:600!important;font-size:14px!important;text-decoration:none!important;transition:background-color .2s ease!important;line-height:24px!important;max-width:100%!important;box-sizing:border-box!important;white-space:nowrap!important;overflow:hidden!important}li[id=\"https://app.writer.com/login\"] svg{margin-left:0!important;height:16px!important;width:16px!important}#topbar-cta-button svg path,li[id=\"https://app.writer.com/login\"] svg path{stroke:#fff!important;stroke-width:1.5!important;stroke-linecap:round!important;fill:none!important}div[id=sidebar-content],div[id=sidebar],ul[class*=\"bg-zinc-950/5\"]{overflow-x:hidden;box-sizing:border-box}ul[class*=\"bg-zinc-950/5\"]{max-width:100%}#content-area.max-w-5xl{max-width:80rem}#content-area.max-w-xl{max-width:60rem!important}img.max-height-800{max-height:800px!important}img.max-width-80{max-width:80%!important}#navbar .nav-tabs{flex:1 1 auto!important;width:100%!important;justify-content:center!important}"}],"page":{"pagePath":"api-reference/completion-api/text-generation","slug":"/api-reference/completion-api/text-generation","pageMetadata":{"openapi":"post /v1/completions","title":"Text generation","description":"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don't require conversational context.","href":"/api-reference/completion-api/text-generation"},"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 text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don’t require conversational context.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Deprecation notice`}),`: Palmyra X4 (`,_jsx(_components.code,{children:`palmyra-x4`}),`) and Palmyra X5 (`,_jsx(_components.code,{children:`palmyra-x5`}),`) will be deprecated on `,_jsx(_components.strong,{children:`December 14, 2026`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Migration path`}),`: Use `,_jsx(_components.a,{href:`/home/models#palmyra-x6`,children:`Palmyra X6`}),` (`,_jsx(_components.code,{children:`palmyra-x6`}),`) instead. Palmyra X6 has a 1M token context window (Palmyra X4 is 128k). See `,_jsx(_components.a,{href:`/home/pricing`,children:`pricing`}),` for cost details and the `,_jsx(_components.a,{href:`/home/models#deprecation-policy`,children:`deprecation policy`}),` for more information.`]})]})}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":{"openapi":"post /v1/completions","title":"Text generation","description":"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don't require conversational context.","href":"/api-reference/completion-api/text-generation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["ac6534f0-53e9-4d51-af76-c9b14775e620"],"tags":["Generation API"],"summary":"Text generation","description":"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don't require conversational context.","operationId":"completions","requestBody":"a5c50cd9-fb2d-42e5-967f-b8a74ccf8a8d","responses":{"200":"8c503d9a-35ec-4e09-af69-c3a98e537dda"},"x-codeSamples":[{"lang":"cURL","source":"curl --location --request POST https://api.writer.com/v1/completions \\\n --header \"Authorization: Bearer \u003ctoken>\" \\\n --header \"Content-Type: application/json\" \\\n--data-raw '{\"model\":\"palmyra-x5\",\"prompt\":\"Write me a short SEO article about camping gear\",\"max_tokens\":150,\"temperature\":0.7,\"top_p\":0.9,\"stop\":[\".\"],\"best_of\":1,\"random_seed\":42,\"stream\":false}'"},{"lang":"JavaScript","source":"import Writer from 'writer-sdk';\n\nconst client = new Writer({\n apiKey: process.env['WRITER_API_KEY'], // This is the default and can be omitted\n});\n\nasync function main() {\n const completion = await client.completions.create({\n model: 'palmyra-x5',\n prompt: 'Write me a short SEO article about camping gear',\n });\n\n console.log(completion.choices);\n}\n\nmain();"},{"lang":"Python","source":"import os\nfrom writerai import Writer\n\nclient = Writer(\n # This is the default and can be omitted\n api_key=os.environ.get(\"WRITER_API_KEY\"),\n)\ncompletion = client.completions.create(\n model=\"palmyra-x5\",\n prompt=\"Write me a short SEO article about camping gear\",\n)\nprint(completion.choices)"}],"method":"post","type":"path","servers":["9ea97f90-7a1e-408e-a662-311712dc7764"],"path":"/v1/completions","baseUrlOptions":["https://api.writer.com"],"title":"Text generation","codeSamples":[{"lang":"cURL","source":"curl --location --request POST https://api.writer.com/v1/completions \\\n --header \"Authorization: Bearer \u003ctoken>\" \\\n --header \"Content-Type: application/json\" \\\n--data-raw '{\"model\":\"palmyra-x5\",\"prompt\":\"Write me a short SEO article about camping gear\",\"max_tokens\":150,\"temperature\":0.7,\"top_p\":0.9,\"stop\":[\".\"],\"best_of\":1,\"random_seed\":42,\"stream\":false}'"},{"lang":"JavaScript","source":"import Writer from 'writer-sdk';\n\nconst client = new Writer({\n apiKey: process.env['WRITER_API_KEY'], // This is the default and can be omitted\n});\n\nasync function main() {\n const completion = await client.completions.create({\n model: 'palmyra-x5',\n prompt: 'Write me a short SEO article about camping gear',\n });\n\n console.log(completion.choices);\n}\n\nmain();"},{"lang":"Python","source":"import os\nfrom writerai import Writer\n\nclient = Writer(\n # This is the default and can be omitted\n api_key=os.environ.get(\"WRITER_API_KEY\"),\n)\ncompletion = client.completions.create(\n model=\"palmyra-x5\",\n prompt=\"Write me a short SEO article about camping gear\",\n)\nprint(completion.choices)"}],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"required":["model","prompt"],"type":"object","properties":{"model":{"type":"string","description":"The [ID of the model](https://dev.writer.com/home/models) to use for generating text. This can be a Palmyra model such as `palmyra-x5` or `palmyra-x4`, or the ID of an [external model](https://dev.writer.com/home/external-models) configured for your organization.","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"type":"string","description":"The input text that the model will process to generate a response.","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"max_tokens":{"type":"integer","format":"int64","description":"The maximum number of tokens that the model can generate in the response.","uniqueKey":"max_tokens","typeLabel":"integer\u003cint64>"},"temperature":{"type":"number","format":"double","description":"Controls the randomness of the model's outputs. Higher values lead to more random outputs, while lower values make the model more deterministic.","uniqueKey":"temperature","typeLabel":"number\u003cdouble>"},"top_p":{"type":"number","format":"double","description":"Used to control the nucleus sampling, where only the most probable tokens with a cumulative probability of top_p are considered for sampling, providing a way to fine-tune the randomness of predictions.","uniqueKey":"top_p","typeLabel":"number\u003cdouble>"},"stop":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"stop.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Specifies stopping conditions for the model's output generation. This can be an array of strings or a single string that the model will look for as a signal to stop generating further tokens.","uniqueKey":"stop.oneOf.0","typeLabel":"string[]"},{"type":"string","description":"Specifies stopping conditions for the model's output generation. This can be an array of strings or a single string that the model will look for as a signal to stop generating further tokens.","uniqueKey":"stop.oneOf.1","typeLabel":"string"}],"uniqueKey":"stop","typeLabel":"string[] | string"},"best_of":{"type":"integer","format":"int32","description":"Specifies the number of completions to generate and return the best one. Useful for generating multiple outputs and choosing the best based on some criteria.","uniqueKey":"best_of","typeLabel":"integer\u003cint32>"},"random_seed":{"type":"integer","format":"int32","description":"A seed used to initialize the random number generator for the model, ensuring reproducibility of the output when the same inputs are provided.","uniqueKey":"random_seed","typeLabel":"integer\u003cint32>"},"stream":{"type":"boolean","description":"Determines whether the model's output should be streamed. If true, the output is generated and sent incrementally, which can be useful for real-time applications.","uniqueKey":"stream","typeLabel":"boolean"}},"example":{"model":"palmyra-x5","prompt":"Write me an SEO article about...","max_tokens":150,"temperature":0.7,"top_p":0.9,"stop":["."],"best_of":1,"random_seed":42,"stream":false},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"palmyra-x5","prompt":"Write me an SEO article about...","max_tokens":150,"temperature":0.7,"top_p":0.9,"stop":["."],"best_of":1,"random_seed":42,"stream":false}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"8c503d9a-35ec-4e09-af69-c3a98e537dda":{"description":"Successful response","content":{"application/json":{"schema":{"required":["choices"],"type":"object","properties":{"choices":{"type":"array","items":{"required":["text"],"type":"object","properties":{"text":{"type":"string","description":"The generated text output from the model, which forms the main content of the response.","isRequired":true,"uniqueKey":"choices.items.[INDEX].text","typeLabel":"string"},"log_probs":{"oneOf":[{"type":"object","required":["content","refusal"],"properties":{"content":{"oneOf":[{"type":"array","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].token","typeLabel":"string"},"logprob":{"type":"number","format":"double","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].logprob","typeLabel":"number\u003cdouble>"},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].token","typeLabel":"string"},"logprob":{"type":"number","format":"double","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].logprob","typeLabel":"number\u003cdouble>"},"bytes":{"type":"array","items":{"type":"integer","format":"int32","uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].bytes.items.[INDEX]","typeLabel":"integer\u003cint32>"},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].bytes","typeLabel":"integer\u003cint32>[]"}},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX]","typeLabel":"top_log_prob · object"},"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].top_logprobs","typeLabel":"top_log_prob · object[]"},"bytes":{"type":"array","items":{"type":"integer","format":"int32","uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].bytes.items.[INDEX]","typeLabel":"integer\u003cint32>"},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX].bytes","typeLabel":"integer\u003cint32>[]"}},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0.items.[INDEX]","typeLabel":"logprobs_token · object"},"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.0","typeLabel":"logprobs_token · object[]"},{"type":"null","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}},"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.content","typeLabel":"logprobs_token · object[] | null"},"refusal":{"oneOf":[{"type":"array","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].token","typeLabel":"string"},"logprob":{"type":"number","format":"double","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].logprob","typeLabel":"number\u003cdouble>"},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].token","typeLabel":"string"},"logprob":{"type":"number","format":"double","isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].logprob","typeLabel":"number\u003cdouble>"},"bytes":{"type":"array","items":{"type":"integer","format":"int32","uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].bytes.items.[INDEX]","typeLabel":"integer\u003cint32>"},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX].bytes","typeLabel":"integer\u003cint32>[]"}},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].top_logprobs.items.[INDEX]","typeLabel":"top_log_prob · object"},"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].top_logprobs","typeLabel":"top_log_prob · object[]"},"bytes":{"type":"array","items":{"type":"integer","format":"int32","uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].bytes.items.[INDEX]","typeLabel":"integer\u003cint32>"},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX].bytes","typeLabel":"integer\u003cint32>[]"}},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0.items.[INDEX]","typeLabel":"logprobs_token · object"},"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.0","typeLabel":"logprobs_token · object[]"},{"type":"null","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}},"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0.refusal","typeLabel":"logprobs_token · object[] | null"}},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.0","typeLabel":"object"},{"type":"null","required":["content","refusal"],"properties":{"content":{"oneOf":[{"type":"array","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}}},{"type":"null","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}}}]},"refusal":{"oneOf":[{"type":"array","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}}},{"type":"null","items":{"title":"logprobs_token","required":["token","logprob","top_logprobs"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}},"top_logprobs":{"type":"array","items":{"title":"top_log_prob","description":"An array of mappings for each token to its top log probabilities, showing detailed prediction probabilities.","required":["token","logprob"],"type":"object","properties":{"token":{"type":"string"},"logprob":{"type":"number","format":"double"},"bytes":{"type":"array","items":{"type":"integer","format":"int32"}}}}}}}}]}},"uniqueKey":"choices.items.[INDEX].log_probs.oneOf.1","typeLabel":"null"}],"uniqueKey":"choices.items.[INDEX].log_probs","typeLabel":"object | null"}},"uniqueKey":"choices.items.[INDEX]","typeLabel":"object"},"minItems":1,"description":"A list of choices generated by the model, each containing the text of the completion and associated metadata such as log probabilities.","isRequired":true,"uniqueKey":"choices","typeLabel":"object[]"},"model":{"type":"string","description":"The identifier of the model that was used to generate the responses in the 'choices' array.","uniqueKey":"model","typeLabel":"string"}},"example":{"choices":[{"text":"Sure! Here's a search engine optimized article about...","log_probs":null}],"model":"palmyra-x5"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"choices":[{"text":"Sure! Here's a search engine optimized article about...","log_probs":null}],"model":"palmyra-x5"}}},"exampleType":"generated"},"text/event-stream":{"schema":{"type":"array","items":{"required":["value"],"type":"object","properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"value":"\u003cstring>"}]}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ac6534f0-53e9-4d51-af76-c9b14775e620":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your [Writer API key](https://dev.writer.com/api-reference/api-keys).","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"9ea97f90-7a1e-408e-a662-311712dc7764":{"url":"https://api.writer.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your [Writer API key](https://dev.writer.com/api-reference/api-keys).","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your [Writer API key](https://dev.writer.com/api-reference/api-keys).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/gateway-api-schema.yaml"},"subdomain":"writer","siteName":"Writer AI Studio","title":"Text generation - Writer AI Studio","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T22:47:43.850Z","originalFileLocation":"api-reference/completion-api/text-generation.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=\"system\"}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 text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don\u0026#x27;t require conversational context.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Writer AI Studio\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_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/writer/rBMYB50U__7D_mBT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Text generation - Writer AI Studio\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don\u0026#x27;t require conversational context.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Writer AI Studio Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dev.writer.com/api-reference/completion-api/text-generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://writer.mintlify.app/_mintlify/api/og/v2?division=Completions+API\u0026amp;title=Text+generation\u0026amp;description=Generate+text+completions+using+the+specified+model+and+prompt.+This+endpoint+is+useful+for+text+generation+tasks+that+don%27t+require+conversational+context.\u0026amp;theme=9c7f3bd87cb846f8ead27220\u0026amp;signature=04decb1af19c452967f3443bf970e478cfd3bed9ae3c3d7366387c218f274307\">\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=\"Text generation - Writer AI Studio\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don\u0026#x27;t require conversational context.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://writer.mintlify.app/_mintlify/api/og/v2?division=Completions+API\u0026amp;title=Text+generation\u0026amp;description=Generate+text+completions+using+the+specified+model+and+prompt.+This+endpoint+is+useful+for+text+generation+tasks+that+don%27t+require+conversational+context.\u0026amp;theme=9c7f3bd87cb846f8ead27220\u0026amp;signature=04decb1af19c452967f3443bf970e478cfd3bed9ae3c3d7366387c218f274307\">\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/writer/rBMYB50U__7D_mBT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Writer AI Studio\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#BFCBFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dev.writer.com/api-reference/completion-api/text-generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/completion-api/text-generation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dev.writer.com/#organization\",\"name\":\"Writer AI Studio\",\"url\":\"https://dev.writer.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/writer/YZ72OUP7BQyK8p2G/logo/writer_logo_light.svg?fit=max\u0026auto=format\u0026n=YZ72OUP7BQyK8p2G\u0026q=85\u0026s=c9a784871f9b98724bb1eae947e745ed\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dev.writer.com#website\",\"name\":\"Writer AI Studio\",\"url\":\"https://dev.writer.com\",\"publisher\":{\"@id\":\"https://dev.writer.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dev.writer.com/api-reference/completion-api/text-generation#webpage\",\"url\":\"https://dev.writer.com/api-reference/completion-api/text-generation\",\"name\":\"Text generation\",\"description\":\"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don't require conversational context.\",\"dateModified\":\"2026-09-14T22:47:43.850Z\",\"isPartOf\":{\"@id\":\"https://dev.writer.com#website\"},\"breadcrumb\":{\"@id\":\"https://dev.writer.com/api-reference/completion-api/text-generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dev.writer.com/api-reference/completion-api/text-generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Completions API\",\"item\":\"https://dev.writer.com/api-reference/completion-api/list-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Text generation\",\"item\":\"https://dev.writer.com/api-reference/completion-api/text-generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://dev.writer.com/api-reference/completion-api/text-generation#apireference\",\"headline\":\"Text generation\",\"name\":\"Text generation\",\"description\":\"Generate text completions using the specified model and prompt. This endpoint is useful for text generation tasks that don't require conversational context.\",\"url\":\"https://dev.writer.com/api-reference/completion-api/text-generation\",\"mainEntityOfPage\":{\"@id\":\"https://dev.writer.com/api-reference/completion-api/text-generation#webpage\"},\"dateModified\":\"2026-09-14T22:47:43.850Z\",\"publisher\":{\"@id\":\"https://dev.writer.com/#organization\"},\"isPartOf\":{\"@id\":\"https://dev.writer.com#website\"}}]}\u003c/script>","siteName":"Writer AI Studio","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/home/introduction"}]},{"tab":"Writer Framework","icon":"shapes","hidden":true,"pages":[{"title":"Writer Framework","href":"/framework/introduction"}]},{"tab":"API Reference","icon":"key","groups":[{"group":"General usage","pages":[{"title":"Manage API keys","sidebarTitle":"API Keys","href":"/api-reference/api-keys"},{"title":"Understand error codes","sidebarTitle":"Error codes","href":"/api-reference/error-codes"},{"title":"Understand rate limits","sidebarTitle":"Rate limits","href":"/api-reference/rate-limits"},{"title":"Paginate API results","sidebarTitle":"Pagination","href":"/api-reference/pagination"},{"title":"Secure your integration","sidebarTitle":"Integration security guide","href":"/api-reference/security"}]},{"group":"Applications API","pages":[{"openapi":"post /v1/applications/{application_id}","title":"Generate from application","href":"/api-reference/application-api/applications"},{"openapi":"get /v1/applications","title":"List applications","href":"/api-reference/application-api/list-applications"},{"openapi":"get /v1/applications/{application_id}","title":"Application details","href":"/api-reference/application-api/application-details"},{"openapi":"post /v1/applications/{application_id}/jobs","title":"Generate from application (async)","href":"/api-reference/application-api/generate-application-job"},{"openapi":"get /v1/applications/{application_id}/jobs","title":"Retrieve all jobs","href":"/api-reference/application-api/application-jobs"},{"openapi":"get /v1/applications/jobs/{job_id}","title":"Retrieve a single job","href":"/api-reference/application-api/get-single-async-job"},{"openapi":"post /v1/applications/jobs/{job_id}/retry","title":"Retry job execution","href":"/api-reference/application-api/post-retry-async-job"},{"openapi":"get /v1/applications/{application_id}/graphs","title":"Retrieve graphs","href":"/api-reference/application-api/get-application-graphs"},{"openapi":"put /v1/applications/{application_id}/graphs","title":"Associate graphs","href":"/api-reference/application-api/put-application-graphs"}]},{"group":"Completions API","pages":[{"openapi":"get /v1/models","title":"List models","description":"Retrieve a list of available models that can be used for text generation, chat completions, and other AI tasks.","href":"/api-reference/completion-api/list-models"},{"openapi":"post /v1/completions","title":"Text generation","href":"/api-reference/completion-api/text-generation"},{"openapi":"post /v1/chat","title":"Chat completion","description":"Generate a chat completion based on the provided messages. The response shown below is for non-streaming. To learn about streaming responses, see the [chat completion guide](https://dev.writer.com/home/chat-completion).","href":"/api-reference/completion-api/chat-completion"}]},{"group":"Files API","pages":[{"openapi":"post /v1/files","title":"Upload file","href":"/api-reference/file-api/upload-files"},{"openapi":"get /v1/files/{file_id}","title":"Retrieve file","href":"/api-reference/file-api/get-file"},{"openapi":"get /v1/files","title":"List files","href":"/api-reference/file-api/get-all-files"},{"openapi":"get /v1/files/{file_id}/download","title":"Download file","href":"/api-reference/file-api/download-file"},{"openapi":"delete /v1/files/{file_id}","title":"Delete file","href":"/api-reference/file-api/delete-file"},{"openapi":"post /v1/files/retry","title":"Retry failed files","href":"/api-reference/file-api/files-retry"}]},{"group":"Knowledge Graphs API","pages":[{"openapi":"post /v1/graphs","title":"Create graph","href":"/api-reference/kg-api/create-graph"},{"openapi":"get /v1/graphs","title":"List graphs","href":"/api-reference/kg-api/list-graphs"},{"openapi":"get /v1/graphs/{graph_id}","title":"Retrieve graph","href":"/api-reference/kg-api/retrieve-graph"},{"openapi":"put /v1/graphs/{graph_id}","title":"Update graph","href":"/api-reference/kg-api/update-graph"},{"openapi":"delete /v1/graphs/{graph_id}","title":"Delete graph","href":"/api-reference/kg-api/delete-graph"},{"openapi":"post /v1/graphs/{graph_id}/file","title":"Add file to graph","href":"/api-reference/kg-api/add-file-to-graph"},{"openapi":"delete /v1/graphs/{graph_id}/file/{file_id}","title":"Remove file from graph","href":"/api-reference/kg-api/remove-file-from-graph"},{"openapi":"post /v1/graphs/question","title":"Question","href":"/api-reference/kg-api/question"}]},{"group":"Tools API","pages":[{"openapi":"post /v1/tools/pdf-parser/{file_id}","title":"Parse PDF","href":"/api-reference/tool-api/pdf-parser"}]}]},{"tab":"Legacy API Reference","hidden":true,"pages":[{"title":"Legacy API Reference","href":"/api-reference-legacy/billing/get-your-organization-subscription-details"}]}]},"basePath":"","title":"Text generation - Writer AI Studio","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}