Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.
Configuration Principles
Most integration failures come from mixing a correct value with the wrong protocol. Verify the following four values together.
Choose the protocol first
Client or SDK
Protocol
Base URL or endpoint
OpenAI SDK, Codex, OpenCode, most chat clients
OpenAI compatible
https://kiosapi.com/v1
Claude Code, Anthropic SDK
Anthropic Messages
https://kiosapi.com with /v1/messages
Google GenAI SDK, Gemini-compatible clients
Gemini native
https://kiosapi.com/v1beta
Match authentication to the protocol
Protocol
Required header
OpenAI compatible
Authorization: Bearer sk-xxx
Anthropic Messages
x-api-key: sk-xxx and anthropic-version: 2023-06-01
Gemini native
x-goog-api-key: sk-xxx
Respect how the client handles /v1
Some clients expect a host and append /v1 themselves. Others expect the complete OpenAI API root. If requests contain /v1/v1, remove /v1 from the configured host. If requests miss /v1, use https://kiosapi.com/v1.
Use exact model IDs
Do not guess model names. Retrieve the currently available IDs:
Use a small curl request first. A successful curl request proves the token, model, route, and network path are valid. Then copy the same values into the target client.
Never send a KiosAPI token to OpenAI, Anthropic, Google, or any unrelated host. KiosAPI tokens are intended only for kiosapi.com.
{"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":"getting-started/configuration-principles","slug":"/getting-started/configuration-principles","pageMetadata":{"title":"Configuration Principles","description":"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.","href":"/getting-started/configuration-principles"},"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: \"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`configuration-principles`,children:`Configuration Principles`}),`\n`,_jsx(_components.p,{children:`Most integration failures come from mixing a correct value with the wrong protocol. Verify the following four values together.`}),`\n`,_jsx(Heading,{level:`2`,id:`choose-the-protocol-first`,children:`Choose the protocol first`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Client or SDK`}),_jsx(_components.th,{children:`Protocol`}),_jsx(_components.th,{children:`Base URL or endpoint`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`OpenAI SDK, Codex, OpenCode, most chat clients`}),_jsx(_components.td,{children:`OpenAI compatible`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://kiosapi.com/v1`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Claude Code, Anthropic SDK`}),_jsx(_components.td,{children:`Anthropic Messages`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`https://kiosapi.com`}),` with `,_jsx(_components.code,{children:`/v1/messages`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Google GenAI SDK, Gemini-compatible clients`}),_jsx(_components.td,{children:`Gemini native`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://kiosapi.com/v1beta`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`match-authentication-to-the-protocol`,children:`Match authentication to the protocol`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Protocol`}),_jsx(_components.th,{children:`Required header`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`OpenAI compatible`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization: Bearer sk-xxx`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Anthropic Messages`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`x-api-key: sk-xxx`}),` and `,_jsx(_components.code,{children:`anthropic-version: 2023-06-01`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gemini native`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`x-goog-api-key: sk-xxx`})})]})]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`respect-how-the-client-handles-/v1`,children:[`Respect how the client handles `,_jsx(_components.code,{children:`/v1`})]}),`\n`,_jsxs(_components.p,{children:[`Some clients expect a host and append `,_jsx(_components.code,{children:`/v1`}),` themselves. Others expect the complete OpenAI API root. If requests contain `,_jsx(_components.code,{children:`/v1/v1`}),`, remove `,_jsx(_components.code,{children:`/v1`}),` from the configured host. If requests miss `,_jsx(_components.code,{children:`/v1`}),`, use `,_jsx(_components.code,{children:`https://kiosapi.com/v1`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-exact-model-ids`,children:`Use exact model IDs`}),`\n`,_jsx(_components.p,{children:`Do not guess model names. Retrieve the currently available IDs:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,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/models`}),_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 `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$KIOSAPI_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`test-before-configuring-a-complex-client`,children:`Test before configuring a complex client`}),`\n`,_jsx(_components.p,{children:`Use a small curl request first. A successful curl request proves the token, model, route, and network path are valid. Then copy the same values into the target client.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Never send a KiosAPI token to OpenAI, Anthropic, Google, or any unrelated host. KiosAPI tokens are intended only for `,_jsx(_components.code,{children:`kiosapi.com`}),`.`]})})]})}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":"Configuration Principles","description":"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.","href":"/getting-started/configuration-principles"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Configuration Principles","slug":"configuration-principles","depth":1,"children":[]},{"title":"Choose the protocol first","slug":"choose-the-protocol-first","depth":2,"children":[]},{"title":"Match authentication to the protocol","slug":"match-authentication-to-the-protocol","depth":2,"children":[]},{"title":"Respect how the client handles /v1","slug":"respect-how-the-client-handles-/v1","depth":2,"children":[]},{"title":"Use exact model IDs","slug":"use-exact-model-ids","depth":2,"children":[]},{"title":"Test before configuring a complex client","slug":"test-before-configuring-a-complex-client","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"kiosapi","siteName":"KiosAPI","title":"Configuration Principles - KiosAPI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/getting-started/configuration-principles","matchLevel":0},"id":{"href":"/id/getting-started/configuration-principles","matchLevel":1}}},"lastModified":"2026-09-21T22:03:01.062Z","originalFileLocation":"getting-started/configuration-principles.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=\"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.\">\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=\"Configuration Principles - KiosAPI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KiosAPI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kiosapi.com/getting-started/configuration-principles\">\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=Configuration+Principles\u0026amp;description=Rules+for+choosing+the+correct+KiosAPI+base+URL%2C+protocol%2C+authentication+header%2C+and+model+ID.\u0026amp;theme=4c2ae8f7e71edf79d2a17a80\u0026amp;signature=d4b6aaee11a975aa8413c6f8240e8cc8ed36978075dc4757dd5c8645ad88ced5\">\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=\"Configuration Principles - KiosAPI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kiosapi.mintlify.site/_mintlify/api/og/v2?division=Quick+Start\u0026amp;title=Configuration+Principles\u0026amp;description=Rules+for+choosing+the+correct+KiosAPI+base+URL%2C+protocol%2C+authentication+header%2C+and+model+ID.\u0026amp;theme=4c2ae8f7e71edf79d2a17a80\u0026amp;signature=d4b6aaee11a975aa8413c6f8240e8cc8ed36978075dc4757dd5c8645ad88ced5\">\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/getting-started/configuration-principles\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/configuration-principles.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.kiosapi.com/getting-started/configuration-principles\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.kiosapi.com/id/getting-started/configuration-principles\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.kiosapi.com/getting-started/configuration-principles\">\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/getting-started/configuration-principles#webpage\",\"url\":\"https://docs.kiosapi.com/getting-started/configuration-principles\",\"name\":\"Configuration Principles\",\"description\":\"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.\",\"dateModified\":\"2026-09-21T22:03:01.062Z\",\"isPartOf\":{\"@id\":\"https://docs.kiosapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kiosapi.com/getting-started/configuration-principles#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kiosapi.com/getting-started/configuration-principles#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Quick Start\",\"item\":\"https://docs.kiosapi.com/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configuration Principles\",\"item\":\"https://docs.kiosapi.com/getting-started/configuration-principles\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kiosapi.com/getting-started/configuration-principles#article\",\"headline\":\"Configuration Principles\",\"name\":\"Configuration Principles\",\"description\":\"Rules for choosing the correct KiosAPI base URL, protocol, authentication header, and model ID.\",\"url\":\"https://docs.kiosapi.com/getting-started/configuration-principles\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kiosapi.com/getting-started/configuration-principles#webpage\"},\"dateModified\":\"2026-09-21T22:03:01.062Z\",\"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":"/getting-started/configuration-principles.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","href":"/getting-started/free-models"},{"title":"Authentication","href":"/authentication"},{"title":"API Base URL","href":"/api-base-url"},{"title":"Quickstart","description":"Get up and running with KiosAPI in minutes using the OpenAI SDK.","href":"/getting-started/quickstart"},{"title":"Configuration Principles","href":"/getting-started/configuration-principles"}]},{"group":"SDKs \u0026 Tools","pages":[{"title":"OpenAI SDK","description":"Detailed guide to using the official OpenAI SDK with KiosAPI across Python and Node.js.","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/getting-started/configuration-principles"}]}]},"basePath":"","title":"Configuration Principles - KiosAPI","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}