Your API key carries full access to your KiosAPI account. Never share it publicly, commit it to version control, or embed it in client-side applications. Use environment variables or a secrets manager to load it at runtime.
Don’t Mix Up Your Base URL and Key
KiosAPI keys are not interchangeable with keys from OpenAI, Anthropic, or Google. Make sure you:
Use a KiosAPI key (sk-kioo-...) for requests to kiosapi.com.
Do not send your KiosAPI key to api.openai.com, api.anthropic.com, or googleapis.com — it will be rejected.
Do not send an OpenAI/Anthropic/Google key to kiosapi.com — it will also be rejected.
Mixing up the base URL and key is the most common cause of 401 Unauthorized errors.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"KiosAPI","description":"KiosAPI developer documentation","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/kiosapi/bkx8tFSdZ73RVr2i/logo/kiosapi.png?fit=max\u0026auto=format\u0026n=bkx8tFSdZ73RVr2i\u0026q=85\u0026s=1190189459ace97346a5c0f6ad71bca7","dark":"https://mintcdn.com/kiosapi/bkx8tFSdZ73RVr2i/logo/kiosapi.png?fit=max\u0026auto=format\u0026n=bkx8tFSdZ73RVr2i\u0026q=85\u0026s=1190189459ace97346a5c0f6ad71bca7"},"favicon":"https://mintcdn.com/kiosapi/bkx8tFSdZ73RVr2i/favicon.png?fit=max\u0026auto=format\u0026n=bkx8tFSdZ73RVr2i\u0026q=85\u0026s=a745a3f6b3ff7bdaaed25b2778454254","navbar":{"links":[{"href":"https://kiosapi.com/pricing","label":"Models \u0026 Pricing"},{"href":"https://github.com/kiosapi","label":"GitHub"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://kiosapi.com"}},"footer":{"socials":{"github":"https://github.com/kiosapi","website":"https://kiosapi.com"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://kiosapi.com"},{"anchor":"Models \u0026 Pricing","icon":"credit-card","href":"https://kiosapi.com/pricing"},{"anchor":"GitHub","icon":"github","href":"https://github.com/kiosapi"}]},"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"id","href":"id/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kiosapi","hasAudioNarration":false,"actualSubdomain":"kiosapi","customDomains":["docs.kiosapi.com"],"gitSource":{"type":"github","owner":"kiosapi","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ab1a9d9bbfbf5b292b2f15f","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"SDKs \u0026 Tools","count":11},{"language":"id","tag":"SDK \u0026 Alat","count":11},{"language":"en","tag":"API Reference","count":10},{"language":"id","tag":"Referensi API","count":10},{"language":"en","tag":"Quick Start","count":8},{"language":"id","tag":"Mulai Cepat","count":8},{"language":"en","tag":"Troubleshooting","count":1},{"language":"id","tag":"Pemecahan Masalah","count":1}]},"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"authentication","slug":"/authentication","pageMetadata":{"title":"Authentication","description":"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.","href":"/authentication"},"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: \"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.\"\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={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`All API requests to KiosAPI require an `,_jsx(_components.strong,{children:`API key`}),` passed in the HTTP header. The exact header you use depends on which endpoint format you’re calling.`]}),`\n`,_jsx(Heading,{level:`2`,id:`api-key`,children:`API Key`}),`\n`,_jsxs(_components.p,{children:[`Your KiosAPI API key starts with `,_jsx(_components.code,{children:`sk-`}),` and looks like:`]}),`\n`,_jsx(CodeBlock,{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:`sk-kioo-xxxxxxxxxxxxxxxxxxxxxxxxxxxx`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Treat your API key as a secret — do not expose it in client-side code, public repositories, or logs.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentication-formats`,children:`Authentication Formats`}),`\n`,_jsx(Heading,{level:`3`,id:`1-openai-format`,children:`1. OpenAI Format`}),`\n`,_jsxs(_components.p,{children:[`Use this when calling the OpenAI-compatible endpoints (`,_jsx(_components.code,{children:`/v1/chat/completions`}),`, `,_jsx(_components.code,{children:`/v1/responses`}),`):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://kiosapi.com/v1/chat/completions`}),_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:` \"Authorization: Bearer sk-kioo-xxxxxxxxxxxx\"`}),_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:` -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:` \"model\": \"gpt-5.5\",`})}),`\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:` {\"role\": \"user\", \"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`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Bearer sk-kioo-xxxxxxxxxxxx`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`This is the most common format. All OpenAI SDK libraries send the key automatically when you set `,_jsx(_components.code,{children:`api_key`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`2-claude-anthropic-native-format`,children:`2. Claude (Anthropic) Native Format`}),`\n`,_jsxs(_components.p,{children:[`Use this when calling the Claude-native endpoint (`,_jsx(_components.code,{children:`/v1/messages`}),`):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://kiosapi.com/v1/messages`}),_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: sk-kioo-xxxxxxxxxxxx\"`}),_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:` \"anthropic-version: 2023-06-01\"`}),_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:` -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:` \"model\": \"claude-sonnet-5\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"max_tokens\": 1024,`})}),`\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:` {\"role\": \"user\", \"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`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`x-api-key`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`sk-kioo-xxxxxxxxxxxx`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`anthropic-version`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2023-06-01`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]})]})]}),`\n`,_jsx(Warning,{title:`anthropic-version is required`,children:_jsxs(_components.p,{children:[`When using the Claude native endpoint, the `,_jsx(_components.code,{children:`anthropic-version`}),` header is `,_jsx(_components.strong,{children:`mandatory`}),`. Omitting it will cause a `,_jsx(_components.code,{children:`400 Bad Request`}),` error.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`3-gemini-google-native-format`,children:`3. Gemini (Google) Native Format`}),`\n`,_jsxs(_components.p,{children:[`Use this when calling the Gemini-native endpoint (`,_jsx(_components.code,{children:`/v1beta/models/{model}:generateContent`}),`):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://kiosapi.com/v1beta/models/gemini-3.8-flash:generateContent\"`}),_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-goog-api-key: sk-kioo-xxxxxxxxxxxx\"`}),_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:` -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:` \"contents\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"parts\": [{\"text\": \"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`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`x-goog-api-key`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`sk-kioo-xxxxxxxxxxxx`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`getting-your-api-key`,children:`Getting Your API Key`}),`\n`,_jsx(_components.p,{children:`You can obtain and manage your API key from the KiosAPI dashboard:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Log in to `,_jsx(_components.a,{href:`https://kiosapi.com`,children:`kiosapi.com`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.strong,{children:`Dashboard > Token Management`}),`.`]}),`\n`,_jsx(_components.li,{children:`Create a new token or copy an existing one.`}),`\n`]}),`\n`,_jsx(Tip,{title:`Keep your key safe`,children:_jsx(_components.p,{children:`Your API key carries full access to your KiosAPI account. Never share it publicly, commit it to version control, or embed it in client-side applications. Use environment variables or a secrets manager to load it at runtime.`})}),`\n`,_jsx(Heading,{level:`2`,id:`don’t-mix-up-your-base-url-and-key`,children:`Don’t Mix Up Your Base URL and Key`}),`\n`,_jsxs(Warning,{title:`Match the correct base URL and API key`,children:[_jsxs(_components.p,{children:[`KiosAPI keys are `,_jsx(_components.strong,{children:`not`}),` interchangeable with keys from OpenAI, Anthropic, or Google. Make sure you:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Use a `,_jsx(_components.strong,{children:`KiosAPI key`}),` (`,_jsx(_components.code,{children:`sk-kioo-...`}),`) for requests to `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`kiosapi.com`})}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Do `,_jsx(_components.strong,{children:`not`}),` send your KiosAPI key to `,_jsx(_components.code,{children:`api.openai.com`}),`, `,_jsx(_components.code,{children:`api.anthropic.com`}),`, or `,_jsx(_components.code,{children:`googleapis.com`}),` — it will be rejected.`]}),`\n`,_jsxs(_components.li,{children:[`Do `,_jsx(_components.strong,{children:`not`}),` send an OpenAI/Anthropic/Google key to `,_jsx(_components.code,{children:`kiosapi.com`}),` — it will also be rejected.`]}),`\n`]}),_jsxs(_components.p,{children:[`Mixing up the base URL and key is the most common cause of `,_jsx(_components.code,{children:`401 Unauthorized`}),` errors.`]})]})]})}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":"Authentication","description":"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.","href":"/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":1,"children":[]},{"title":"API Key","slug":"api-key","depth":2,"children":[]},{"title":"Authentication Formats","slug":"authentication-formats","depth":2,"children":[{"title":"1. OpenAI Format","slug":"1-openai-format","depth":3,"children":[]},{"title":"2. Claude (Anthropic) Native Format","slug":"2-claude-anthropic-native-format","depth":3,"children":[]},{"title":"3. Gemini (Google) Native Format","slug":"3-gemini-google-native-format","depth":3,"children":[]}]},{"title":"Getting Your API Key","slug":"getting-your-api-key","depth":2,"children":[]},{"title":"Don’t Mix Up Your Base URL and Key","slug":"don’t-mix-up-your-base-url-and-key","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"kiosapi","siteName":"KiosAPI","title":"Authentication - KiosAPI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/authentication","matchLevel":0},"id":{"href":"/id/authentication","matchLevel":1}}},"lastModified":"2026-09-21T22:03:01.059Z","originalFileLocation":"authentication.mdx","locale":"en"},"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=\"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KiosAPI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_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/kiosapi/wCf4JAT8Lwu3i0Gd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - KiosAPI\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KiosAPI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kiosapi.com/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kiosapi.mintlify.site/_mintlify/api/og/v2?division=Quick+Start\u0026amp;title=Authentication\u0026amp;description=How+to+authenticate+API+requests+to+KiosAPI+using+OpenAI%2C+Claude%2C+or+Gemini+header+formats.\u0026amp;theme=4c2ae8f7e71edf79d2a17a80\u0026amp;signature=e884a3980d29ff8bc1d24246cd51c242cac20a7103c9509db37f2a1e7a9f3662\">\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=\"Authentication - KiosAPI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kiosapi.mintlify.site/_mintlify/api/og/v2?division=Quick+Start\u0026amp;title=Authentication\u0026amp;description=How+to+authenticate+API+requests+to+KiosAPI+using+OpenAI%2C+Claude%2C+or+Gemini+header+formats.\u0026amp;theme=4c2ae8f7e71edf79d2a17a80\u0026amp;signature=e884a3980d29ff8bc1d24246cd51c242cac20a7103c9509db37f2a1e7a9f3662\">\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/kiosapi/wCf4JAT8Lwu3i0Gd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KiosAPI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kiosapi.com/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/authentication.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.kiosapi.com/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.kiosapi.com/id/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.kiosapi.com/authentication\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kiosapi.com/#organization\",\"name\":\"KiosAPI\",\"url\":\"https://docs.kiosapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kiosapi/bkx8tFSdZ73RVr2i/logo/kiosapi.png?fit=max\u0026auto=format\u0026n=bkx8tFSdZ73RVr2i\u0026q=85\u0026s=1190189459ace97346a5c0f6ad71bca7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kiosapi.com#website\",\"name\":\"KiosAPI\",\"url\":\"https://docs.kiosapi.com\",\"publisher\":{\"@id\":\"https://docs.kiosapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kiosapi.com/authentication#webpage\",\"url\":\"https://docs.kiosapi.com/authentication\",\"name\":\"Authentication\",\"description\":\"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.\",\"dateModified\":\"2026-09-21T22:03:01.059Z\",\"isPartOf\":{\"@id\":\"https://docs.kiosapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kiosapi.com/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kiosapi.com/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Quick Start\",\"item\":\"https://docs.kiosapi.com/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.kiosapi.com/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kiosapi.com/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"How to authenticate API requests to KiosAPI using OpenAI, Claude, or Gemini header formats.\",\"url\":\"https://docs.kiosapi.com/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kiosapi.com/authentication#webpage\"},\"dateModified\":\"2026-09-21T22:03:01.059Z\",\"publisher\":{\"@id\":\"https://docs.kiosapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kiosapi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"KiosAPI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"KiosAPI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/authentication.md","siteName":"KiosAPI","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://kiosapi.com"},{"anchor":"Models \u0026 Pricing","icon":"credit-card","href":"https://kiosapi.com/pricing"},{"anchor":"GitHub","icon":"github","href":"https://github.com/kiosapi"}]},"languages":[{"language":"en","default":true,"groups":[{"group":"Quick Start","pages":[{"title":"KiosAPI Introduction","href":"/introduction"},{"title":"Account and API Key","href":"/getting-started/register"},{"title":"Choosing a Token Group","href":"/getting-started/token-groups"},{"title":"Free Models and Telegram Verification","description":"Verify with the KiosAPI Telegram bot to unlock the free model group at zero cost.","href":"/getting-started/free-models"},{"title":"Authentication","href":"/authentication"},{"title":"API Base URL","description":"The KiosAPI base URL and how to configure it correctly with your API key.","href":"/api-base-url"},{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Configuration Principles","href":"/getting-started/configuration-principles"}]},{"group":"SDKs \u0026 Tools","pages":[{"title":"OpenAI SDK","href":"/getting-started/openai-sdk"},{"title":"Concurrency","href":"/getting-started/concurrency"},{"title":"CC Switch","href":"/tutorials/cc-switch"},{"title":"Claude Code","href":"/tutorials/claude-code"},{"title":"OpenAI Codex CLI","href":"/tutorials/codex"},{"title":"Gemini CLI","href":"/tutorials/gemini-cli"},{"title":"OpenCode","href":"/tutorials/opencode"},{"title":"OpenClaw","href":"/tutorials/openclaw"},{"title":"Trae","href":"/tutorials/trae"},{"title":"Configure Hermes Agent with KiosAPI","href":"/tutorials/hermes-agent"},{"title":"Test KiosAPI with cURL","href":"/tutorials/curl"}]},{"group":"API Reference","pages":[{"title":"List Available Models","href":"/api-reference/models/list-models"},{"title":"List Single Model","href":"/api-reference/models/list-single-model"},{"title":"Chat Completions (General)","href":"/api-reference/chat/general"},{"title":"Chat - Image Analysis (Vision)","href":"/api-reference/chat/vision"},{"title":"Chat - Function Calling","href":"/api-reference/chat/function-calling"},{"title":"Claude (OpenAI Format) - PDF Analysis","href":"/api-reference/chat/claude-openai"},{"title":"Claude (Native Format) - PDF Analysis","href":"/api-reference/chat/claude-native"},{"title":"Gemini (OpenAI Format) - File Analysis","href":"/api-reference/chat/gemini-openai"},{"title":"Gemini (Native Format) - File Analysis","href":"/api-reference/chat/gemini-native"},{"title":"Chat - Completions (Legacy)","href":"/api-reference/chat/completions"}]},{"group":"Troubleshooting","pages":[{"title":"Error Codes and Troubleshooting","href":"/troubleshooting/errors"}]}]},{"language":"id","pages":[{"title":"id","href":"/id/authentication"}]}]},"basePath":"","title":"Authentication - KiosAPI","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}