Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.
Prinsip Konfigurasi
Sebagian besar kegagalan integrasi terjadi karena nilai yang benar dipakai pada protokol yang salah. Periksa empat bagian berikut sebagai satu kesatuan.
Tentukan protokol terlebih dahulu
Klien atau SDK
Protokol
Base URL atau endpoint
OpenAI SDK, Codex, OpenCode, mayoritas klien chat
OpenAI compatible
https://kiosapi.com/v1
Claude Code, Anthropic SDK
Anthropic Messages
https://kiosapi.com dengan /v1/messages
Google GenAI SDK, klien Gemini
Gemini native
https://kiosapi.com/v1beta
Cocokkan autentikasi dengan protokol
Protokol
Header wajib
OpenAI compatible
Authorization: Bearer sk-xxx
Anthropic Messages
x-api-key: sk-xxx dan anthropic-version: 2023-06-01
Gemini native
x-goog-api-key: sk-xxx
Perhatikan cara klien menangani /v1
Sebagian klien meminta host lalu menambahkan /v1 sendiri. Klien lain meminta root API OpenAI lengkap. Jika URL request menjadi /v1/v1, hapus /v1 dari konfigurasi host. Jika /v1 hilang, gunakan https://kiosapi.com/v1.
Gunakan ID model yang persis
Jangan menebak nama model. Ambil daftar ID yang tersedia saat ini:
Jalankan request curl kecil terlebih dahulu. Curl yang berhasil membuktikan token, model, route, dan koneksi jaringan sudah benar. Setelah itu pindahkan nilai yang sama ke klien tujuan.
Jangan pernah mengirim token KiosAPI ke OpenAI, Anthropic, Google, atau host lain. Token KiosAPI hanya digunakan untuk 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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"id/getting-started/configuration-principles","slug":"/id/getting-started/configuration-principles","pageMetadata":{"title":"Prinsip Konfigurasi","description":"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.","href":"/id/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: \"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.\"\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:`prinsip-konfigurasi`,children:`Prinsip Konfigurasi`}),`\n`,_jsx(_components.p,{children:`Sebagian besar kegagalan integrasi terjadi karena nilai yang benar dipakai pada protokol yang salah. Periksa empat bagian berikut sebagai satu kesatuan.`}),`\n`,_jsx(Heading,{level:`2`,id:`tentukan-protokol-terlebih-dahulu`,children:`Tentukan protokol terlebih dahulu`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Klien atau SDK`}),_jsx(_components.th,{children:`Protokol`}),_jsx(_components.th,{children:`Base URL atau endpoint`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`OpenAI SDK, Codex, OpenCode, mayoritas klien chat`}),_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`}),` dengan `,_jsx(_components.code,{children:`/v1/messages`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Google GenAI SDK, klien Gemini`}),_jsx(_components.td,{children:`Gemini native`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://kiosapi.com/v1beta`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`cocokkan-autentikasi-dengan-protokol`,children:`Cocokkan autentikasi dengan protokol`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Protokol`}),_jsx(_components.th,{children:`Header wajib`})]})}),_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`}),` dan `,_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:`perhatikan-cara-klien-menangani-/v1`,children:[`Perhatikan cara klien menangani `,_jsx(_components.code,{children:`/v1`})]}),`\n`,_jsxs(_components.p,{children:[`Sebagian klien meminta host lalu menambahkan `,_jsx(_components.code,{children:`/v1`}),` sendiri. Klien lain meminta root API OpenAI lengkap. Jika URL request menjadi `,_jsx(_components.code,{children:`/v1/v1`}),`, hapus `,_jsx(_components.code,{children:`/v1`}),` dari konfigurasi host. Jika `,_jsx(_components.code,{children:`/v1`}),` hilang, gunakan `,_jsx(_components.code,{children:`https://kiosapi.com/v1`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`gunakan-id-model-yang-persis`,children:`Gunakan ID model yang persis`}),`\n`,_jsx(_components.p,{children:`Jangan menebak nama model. Ambil daftar ID yang tersedia saat ini:`}),`\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:`uji-sebelum-mengatur-klien-yang-kompleks`,children:`Uji sebelum mengatur klien yang kompleks`}),`\n`,_jsx(_components.p,{children:`Jalankan request curl kecil terlebih dahulu. Curl yang berhasil membuktikan token, model, route, dan koneksi jaringan sudah benar. Setelah itu pindahkan nilai yang sama ke klien tujuan.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Jangan pernah mengirim token KiosAPI ke OpenAI, Anthropic, Google, atau host lain. Token KiosAPI hanya digunakan untuk `,_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":"Prinsip Konfigurasi","description":"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.","href":"/id/getting-started/configuration-principles"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prinsip Konfigurasi","slug":"prinsip-konfigurasi","depth":1,"children":[]},{"title":"Tentukan protokol terlebih dahulu","slug":"tentukan-protokol-terlebih-dahulu","depth":2,"children":[]},{"title":"Cocokkan autentikasi dengan protokol","slug":"cocokkan-autentikasi-dengan-protokol","depth":2,"children":[]},{"title":"Perhatikan cara klien menangani /v1","slug":"perhatikan-cara-klien-menangani-/v1","depth":2,"children":[]},{"title":"Gunakan ID model yang persis","slug":"gunakan-id-model-yang-persis","depth":2,"children":[]},{"title":"Uji sebelum mengatur klien yang kompleks","slug":"uji-sebelum-mengatur-klien-yang-kompleks","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"kiosapi","siteName":"KiosAPI","title":"Prinsip Konfigurasi - KiosAPI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/getting-started/configuration-principles","matchLevel":1},"id":{"href":"/id/getting-started/configuration-principles","matchLevel":0}}},"lastModified":"2026-09-21T22:03:01.065Z","originalFileLocation":"id/getting-started/configuration-principles.mdx","locale":"id"},"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=\"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.\">\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=\"Prinsip Konfigurasi - KiosAPI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KiosAPI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kiosapi.com/id/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=Mulai+Cepat\u0026amp;title=Prinsip+Konfigurasi\u0026amp;description=Aturan+memilih+base+URL%2C+protokol%2C+header+autentikasi%2C+dan+ID+model+KiosAPI+yang+benar.\u0026amp;theme=4c2ae8f7e71edf79d2a17a80\u0026amp;signature=150091fe6adf89de81af25cfaa2335add001dc810b2d0ee9736804008dac1440\">\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=\"Prinsip Konfigurasi - KiosAPI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kiosapi.mintlify.site/_mintlify/api/og/v2?division=Mulai+Cepat\u0026amp;title=Prinsip+Konfigurasi\u0026amp;description=Aturan+memilih+base+URL%2C+protokol%2C+header+autentikasi%2C+dan+ID+model+KiosAPI+yang+benar.\u0026amp;theme=4c2ae8f7e71edf79d2a17a80\u0026amp;signature=150091fe6adf89de81af25cfaa2335add001dc810b2d0ee9736804008dac1440\">\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/id/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=\"/id/getting-started/configuration-principles.md\">\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=\"en\" href=\"https://docs.kiosapi.com/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/id/getting-started/configuration-principles#webpage\",\"url\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles\",\"name\":\"Prinsip Konfigurasi\",\"description\":\"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.\",\"dateModified\":\"2026-09-21T22:03:01.065Z\",\"isPartOf\":{\"@id\":\"https://docs.kiosapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mulai Cepat\",\"item\":\"https://docs.kiosapi.com/id/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Prinsip Konfigurasi\",\"item\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles#article\",\"headline\":\"Prinsip Konfigurasi\",\"name\":\"Prinsip Konfigurasi\",\"description\":\"Aturan memilih base URL, protokol, header autentikasi, dan ID model KiosAPI yang benar.\",\"url\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kiosapi.com/id/getting-started/configuration-principles#webpage\"},\"dateModified\":\"2026-09-21T22:03:01.065Z\",\"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":"/id/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,"pages":[{"title":"en","href":"/getting-started/configuration-principles"}]},{"language":"id","groups":[{"group":"Mulai Cepat","pages":[{"title":"Pendahuluan","href":"/id/introduction"},{"title":"Akun dan API Key","href":"/id/getting-started/register"},{"title":"Memilih Grup Token","href":"/id/getting-started/token-groups"},{"title":"Model Gratis dan Verifikasi Telegram","href":"/id/getting-started/free-models"},{"title":"Autentikasi","href":"/id/authentication"},{"title":"API Base URL","href":"/id/api-base-url"},{"title":"Quickstart","description":"Kirim permintaan pertama ke KiosAPI menggunakan OpenAI SDK.","href":"/id/getting-started/quickstart"},{"title":"Prinsip Konfigurasi","href":"/id/getting-started/configuration-principles"}]},{"group":"SDK \u0026 Alat","pages":[{"title":"OpenAI SDK","description":"Gunakan OpenAI SDK Python atau Node.js dengan KiosAPI.","href":"/id/getting-started/openai-sdk"},{"title":"Concurrency","href":"/id/getting-started/concurrency"},{"title":"CC Switch","href":"/id/tools/cc-switch"},{"title":"Claude Code","href":"/id/tools/claude-code"},{"title":"OpenAI Codex CLI","href":"/id/tools/codex"},{"title":"Gemini CLI","href":"/id/tools/gemini-cli"},{"title":"OpenCode","href":"/id/tools/opencode"},{"title":"OpenClaw","href":"/id/tools/openclaw"},{"title":"Trae","href":"/id/tools/trae"},{"title":"Hermes Agent","href":"/id/tools/hermes-agent"},{"title":"curl","href":"/id/tools/curl"}]},{"group":"Referensi API","pages":[{"title":"Daftar Model yang Tersedia","href":"/id/api-reference/models/list-models"},{"title":"Daftar Model Tunggal","href":"/id/api-reference/models/list-single-model"},{"title":"Penyelesaian Obrolan (Umum)","href":"/id/api-reference/chat/general"},{"title":"Obrolan - Analisis Gambar (Visi)","href":"/id/api-reference/chat/vision"},{"title":"Obrolan - Fungsi Memanggil","href":"/id/api-reference/chat/function-calling"},{"title":"Claude (Format OpenAI) - Analisis PDF","href":"/id/api-reference/chat/claude-openai"},{"title":"Claude (Format Asli) - Analisis PDF","href":"/id/api-reference/chat/claude-native"},{"title":"Gemini (Format OpenAI) - Analisis File","href":"/id/api-reference/chat/gemini-openai"},{"title":"Gemini (Format Asli) - Analisis File","href":"/id/api-reference/chat/gemini-native"},{"title":"Obrolan - Penyelesaian (Warisan)","href":"/id/api-reference/chat/completions"}]},{"group":"Pemecahan Masalah","pages":[{"title":"Kode Error dan Pemecahan Masalah","href":"/id/troubleshooting/errors"}]}]}]},"basePath":"","title":"Prinsip Konfigurasi - KiosAPI","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}