API key (api_key), endpoint (api_base), API version (api_version), deployment name (deployment_name)
Bedrock
Access key (aws_access_key_id), secret key (aws_secret_access_key), region (aws_region_name)
Gemini
API key (api_key)
Vertex AI
Google application credentials JSON (google_application_credentials), project ID (vertexai_project), location (vertexai_location)
OAuth Gateway (self-hosted only)
Gateway API base URL (api_base), OAuth2 token endpoint (oauth_token_url), client ID (oauth_client_id), private key PEM (oauth_private_key_pem), audience (oauth_audience). Optional: space-separated scopes (oauth_scopes), extra HTTP headers, one per line (oauth_extra_headers), JWT signing algorithm (oauth_algorithm: PS256 (default), ES256, or RS256; match the algorithm your identity provider registered the client for)
Find the provider you want to use and click the pencil icon.
Enter the required credentials.
Click Save.
A green indicator and Configured status show that the required credentials have been saved for the provider.
Provider keys are configured at the workspace level. All projects within the workspace share the same provider keys.
Workspace Admins have full control over provider keys (create, read, update, delete). Workspace Members can view provider configuration status and use configured providers, but cannot view plaintext secret values or modify credentials. See Roles for details.
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"HoneyHive AI Docs","description":"AI observability and evaluation platform. Trace, evaluate, monitor, and improve AI agents and LLM applications.","colors":{"primary":"#A56311","light":"#E8A23D","dark":"#A56311"},"logo":{"light":"https://mintcdn.com/honeyhiveai/lWy7JAPdMsmL06l1/logo/light.svg?fit=max\u0026auto=format\u0026n=lWy7JAPdMsmL06l1\u0026q=85\u0026s=419c99bb22ce1e89ae8fb4a87c589528","dark":"https://mintcdn.com/honeyhiveai/lWy7JAPdMsmL06l1/logo/dark.svg?fit=max\u0026auto=format\u0026n=lWy7JAPdMsmL06l1\u0026q=85\u0026s=2cee835bc5438cd29005218a18e0168b"},"favicon":{"light":"https://mintcdn.com/honeyhiveai/W7aN2oGPMTbOQxZv/images/favicon.svg?fit=max\u0026auto=format\u0026n=W7aN2oGPMTbOQxZv\u0026q=85\u0026s=1c201da27b06120f1c630bf53ad1a831","dark":"https://mintcdn.com/honeyhiveai/W7aN2oGPMTbOQxZv/images/favicon-dark.svg?fit=max\u0026auto=format\u0026n=W7aN2oGPMTbOQxZv\u0026q=85\u0026s=01cb0bffc66454f0e19853e701832110"},"api":{"openapi":["output.yaml","https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml","https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/control_plane_openapi.yaml"],"mdx":{"auth":{"method":"key","name":"key"},"server":"https://api.dp1.us.honeyhive.ai"}},"appearance":{"default":"light"},"background":{"color":{"light":"#ffffff","dark":"#101010"}},"navbar":{"links":[{"href":"https://discord.gg/vqctGpqA97","label":"Community"}],"primary":{"type":"button","label":"Log In","href":"https://app.us.honeyhive.ai"}},"footer":{"socials":{"x":"https://x.com/honeyhiveai","linkedin":"https://www.linkedin.com/company/honeyhive-ai","github":"https://github.com/honeyhiveai"},"links":[{"header":"Resources","items":[{"label":"Quickstart","href":"https://docs.honeyhive.ai/v2/introduction/tracing-quickstart"},{"label":"SDK Reference","href":"https://docs.honeyhive.ai/v2/sdk-reference/overview"},{"label":"API Reference","href":"https://docs.honeyhive.ai/v2/api-reference-autogen/sessions/start-a-new-session"},{"label":"Integrations","href":"https://docs.honeyhive.ai/v2/integrations/openai"},{"label":"Changelog","href":"https://docs.honeyhive.ai/v2/changelog/product"}]},{"header":"Explore","items":[{"label":"Sign Up","href":"https://app.us.honeyhive.ai"},{"label":"Pricing","href":"https://www.honeyhive.ai/pricing"},{"label":"Blog","href":"https://honeyhive.ai/blog"}]},{"header":"Platform","items":[{"label":"Observability","href":"https://honeyhive.ai/observability"},{"label":"Evaluation","href":"https://honeyhive.ai/evaluation"},{"label":"Prompt Management","href":"https://honeyhive.ai/playground"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://honeyhive.ai/terms"},{"label":"Privacy Policy","href":"https://honeyhive.ai/privacy"}]}]},"search":{"prompt":"Search or ask AI..."},"seo":{"metatags":{"og:site_name":"HoneyHive AI Docs"},"indexing":"navigable"},"integrations":{"posthog":{"apiKey":"phc_CtmMXHNhIs1Iem8viAsXYH7lB0aaj4X2nCrCunPqDbF","sessionRecording":false},"telemetry":{"enabled":true}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode",{"title":"Join Discord","description":"Get help from the HoneyHive community","icon":"discord","href":"https://discord.gg/vqctGpqA97"}],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"honeyhiveai","hasAudioNarration":false,"actualSubdomain":"honeyhiveai","customDomains":["docs.honeyhive.ai"],"gitSource":{"type":"github","owner":"honeyhiveai","repo":"honeyhive-ai-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"issues":false,"edits":false,"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aee1313a829c37e3ffc25d8","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"v2","count":395},{"language":"default","tag":"SDK Reference","count":175},{"language":"default","tag":"Reference","count":172},{"language":"default","tag":"TypeScript API SDK","count":114},{"language":"default","tag":"Documentation","count":91},{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Data Plane API","count":51},{"language":"default","tag":"TypeScript Control Plane SDK","count":50},{"language":"default","tag":"Experiments","count":40},{"language":"default","tag":"Integrations","count":34}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@honeyhive.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".update-container .hh-update-entry:first-child>h2{margin-top:0}"}],"page":{"pagePath":"v2/workspace/provider-keys","slug":"/v2/workspace/provider-keys","pageMetadata":{"title":"Provider Keys","description":"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.","icon":"key","href":"/v2/workspace/provider-keys"},"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: \"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.\"\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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Note,OptimizedImage,Table}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Provider keys let HoneyHive make API calls to AI providers on your behalf. These are used for:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LLM Evaluators`}),` - Run AI-powered evaluations on your traces. See `,_jsx(_components.a,{href:`/v2/evaluators/llm#set-up-an-llm-provider`,children:`LLM Evaluators`}),` for setup.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Playground`}),` - Test prompts directly in HoneyHive`]}),`\n`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=0d0fcffd9890fbbb0c0d16acfea6db96`,alt:`AI Provider Secrets settings page`,\"data-og-width\":`3014`,width:`3014`,\"data-og-height\":`1276`,height:`1276`,\"data-path\":`images/ai-provider-secrets.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?w=280\u0026fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=b0274fd94ab212b8d9003a7166edaff6 280w, https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?w=560\u0026fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=ea27a0d1b662bbb89bcdebb7539cb1b8 560w, https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?w=840\u0026fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=dfe48121b2c3ab1580553b41b8410675 840w, https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?w=1100\u0026fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=602f926cdd8d7d700d45e6cfecb403ee 1100w, https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?w=1650\u0026fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=7ebd9475473cab2b6f079cfb43ba4b77 1650w, https://mintcdn.com/honeyhiveai/8CSzfyX-NUZzkr98/images/ai-provider-secrets.png?w=2500\u0026fit=max\u0026auto=format\u0026n=8CSzfyX-NUZzkr98\u0026q=85\u0026s=eabb5e5e34550bb3d34791663dee0b2f 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-providers`,children:`Supported providers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Provider`}),_jsx(_components.th,{children:`Required credentials`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Anthropic`}),_jsxs(_components.td,{children:[`API key (`,_jsx(_components.code,{children:`api_key`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`OpenAI`}),_jsxs(_components.td,{children:[`API key (`,_jsx(_components.code,{children:`api_key`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Azure OpenAI`}),_jsxs(_components.td,{children:[`API key (`,_jsx(_components.code,{children:`api_key`}),`), endpoint (`,_jsx(_components.code,{children:`api_base`}),`), API version (`,_jsx(_components.code,{children:`api_version`}),`), deployment name (`,_jsx(_components.code,{children:`deployment_name`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bedrock`}),_jsxs(_components.td,{children:[`Access key (`,_jsx(_components.code,{children:`aws_access_key_id`}),`), secret key (`,_jsx(_components.code,{children:`aws_secret_access_key`}),`), region (`,_jsx(_components.code,{children:`aws_region_name`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gemini`}),_jsxs(_components.td,{children:[`API key (`,_jsx(_components.code,{children:`api_key`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Vertex AI`}),_jsxs(_components.td,{children:[`Google application credentials JSON (`,_jsx(_components.code,{children:`google_application_credentials`}),`), project ID (`,_jsx(_components.code,{children:`vertexai_project`}),`), location (`,_jsx(_components.code,{children:`vertexai_location`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`OAuth Gateway (self-hosted only)`}),_jsxs(_components.td,{children:[`Gateway API base URL (`,_jsx(_components.code,{children:`api_base`}),`), OAuth2 token endpoint (`,_jsx(_components.code,{children:`oauth_token_url`}),`), client ID (`,_jsx(_components.code,{children:`oauth_client_id`}),`), private key PEM (`,_jsx(_components.code,{children:`oauth_private_key_pem`}),`), audience (`,_jsx(_components.code,{children:`oauth_audience`}),`). Optional: space-separated scopes (`,_jsx(_components.code,{children:`oauth_scopes`}),`), extra HTTP headers, one per line (`,_jsx(_components.code,{children:`oauth_extra_headers`}),`), JWT signing algorithm (`,_jsx(_components.code,{children:`oauth_algorithm`}),`: `,_jsx(_components.code,{children:`PS256`}),` (default), `,_jsx(_components.code,{children:`ES256`}),`, or `,_jsx(_components.code,{children:`RS256`}),`; match the algorithm your identity provider registered the client for)`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`configuring-provider-keys`,children:`Configuring provider keys`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Settings > Workspace > AI Providers`}),`.`]}),`\n`,_jsx(_components.li,{children:`Find the provider you want to use and click the pencil icon.`}),`\n`,_jsx(_components.li,{children:`Enter the required credentials.`}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A green indicator and `,_jsx(_components.strong,{children:`Configured`}),` status show that the required credentials have been saved for the provider.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Provider keys are configured at the `,_jsx(_components.strong,{children:`workspace level`}),`. All projects within the workspace share the same provider keys.`]})}),`\n`,_jsxs(_components.p,{children:[`Workspace Admins have full control over provider keys (create, read, update, delete). Workspace Members can view provider configuration status and use configured providers, but cannot view plaintext secret values or modify credentials. See `,_jsx(_components.a,{href:`/v2/workspace/roles`,children:`Roles`}),` for details.`]})]})}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":"Provider Keys","description":"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.","icon":"key","href":"/v2/workspace/provider-keys"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Supported providers","slug":"supported-providers","depth":2,"children":[]},{"title":"Configuring provider keys","slug":"configuring-provider-keys","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/honeyhiveai/295d4d275d20dba2/leadfeeder.js"],"subdomain":"honeyhiveai","siteName":"HoneyHive AI Docs","title":"Provider Keys - HoneyHive AI Docs","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T23:47:05.259Z","originalFileLocation":"v2/workspace/provider-keys.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HoneyHive AI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Provider Keys - HoneyHive AI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HoneyHive AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.honeyhive.ai/v2/workspace/provider-keys\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://honeyhiveai.mintlify.site/_mintlify/api/og/v2?division=Organization\u0026amp;title=Provider+Keys\u0026amp;description=Configure+AI+provider+API+keys+for+LLM+evaluators+and+the+Playground+in+HoneyHive.+Store+credentials+securely+and+scope+provider+access+by+workspace.\u0026amp;theme=5d33c6c4b6bf57211dea5b47\u0026amp;signature=c4e35aaa131ac23b9afccf81680c67d360b032314facc760b69a6bc5193ae478\">\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=\"Provider Keys - HoneyHive AI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://honeyhiveai.mintlify.site/_mintlify/api/og/v2?division=Organization\u0026amp;title=Provider+Keys\u0026amp;description=Configure+AI+provider+API+keys+for+LLM+evaluators+and+the+Playground+in+HoneyHive.+Store+credentials+securely+and+scope+provider+access+by+workspace.\u0026amp;theme=5d33c6c4b6bf57211dea5b47\u0026amp;signature=c4e35aaa131ac23b9afccf81680c67d360b032314facc760b69a6bc5193ae478\">\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/honeyhiveai/XiZ-DZ6IaFrWYjlm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HoneyHive AI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A56311\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.honeyhive.ai/v2/workspace/provider-keys\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v2/workspace/provider-keys.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.honeyhive.ai/#organization\",\"name\":\"HoneyHive AI Docs\",\"url\":\"https://docs.honeyhive.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/honeyhiveai/lWy7JAPdMsmL06l1/logo/light.svg?fit=max\u0026auto=format\u0026n=lWy7JAPdMsmL06l1\u0026q=85\u0026s=419c99bb22ce1e89ae8fb4a87c589528\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.honeyhive.ai#website\",\"name\":\"HoneyHive AI Docs\",\"url\":\"https://docs.honeyhive.ai\",\"publisher\":{\"@id\":\"https://docs.honeyhive.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys#webpage\",\"url\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys\",\"name\":\"Provider Keys\",\"description\":\"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.\",\"dateModified\":\"2026-09-24T23:47:05.259Z\",\"isPartOf\":{\"@id\":\"https://docs.honeyhive.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Administration\",\"item\":\"https://docs.honeyhive.ai/v2/workspace/organization-hierarchy\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Organization\",\"item\":\"https://docs.honeyhive.ai/v2/workspace/organization-hierarchy\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Provider Keys\",\"item\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys#article\",\"headline\":\"Provider Keys\",\"name\":\"Provider Keys\",\"description\":\"Configure AI provider API keys for LLM evaluators and the Playground in HoneyHive. Store credentials securely and scope provider access by workspace.\",\"url\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys\",\"mainEntityOfPage\":{\"@id\":\"https://docs.honeyhive.ai/v2/workspace/provider-keys#webpage\"},\"dateModified\":\"2026-09-24T23:47:05.259Z\",\"publisher\":{\"@id\":\"https://docs.honeyhive.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.honeyhive.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HoneyHive AI Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"HoneyHive AI Docs","nav":{"global":{},"products":[{"product":"v2","icon":"hive","description":"The next generation of HoneyHive.","tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Introducing HoneyHive","sidebarTitle":"Introduction","icon":"square-info","href":"/v2/introduction/what-is-hhai"},{"group":"Getting Started","pages":[{"title":"How to Trace Your First Agent","sidebarTitle":"Log Your First Trace","icon":"rocket","href":"/v2/introduction/tracing-quickstart"},{"title":"How to Run Your First Experiment","sidebarTitle":"Run Your First Eval","icon":"flask","href":"/v2/introduction/experiments-quickstart"},{"title":"Use with Coding Agents","sidebarTitle":"Use with Coding Agents","icon":"robot","href":"/v2/introduction/ai-coding-agents"},{"title":"Troubleshooting \u0026 FAQs","icon":"square-question","href":"/v2/introduction/troubleshooting"}]},{"group":"Observability","pages":[{"group":"Tracing","icon":"list-tree","pages":[{"title":"AI Application Tracing with HoneyHive","sidebarTitle":"Introduction","href":"/v2/tracing/introduction"},{"title":"HoneyHive Tracing Concepts","sidebarTitle":"Concepts","href":"/v2/tracing/concepts"},{"title":"How to Create Custom Spans in HoneyHive","sidebarTitle":"Custom Spans","href":"/v2/tracing/custom-spans"},{"title":"How to Initialize the HoneyHive Tracer","sidebarTitle":"Tracer Initialization","href":"/v2/tracing/tracer-initialization"},{"group":"Enriching Traces","pages":[{"title":"How to Enrich Traces with Metadata and Metrics","sidebarTitle":"Overview","href":"/v2/tracing/enrich-traces"},{"title":"Schema Reference","href":"/v2/tracing/enrichment-schema"},{"title":"User Feedback","href":"/v2/tracing/setting-user-feedback"},{"title":"Custom Metrics","href":"/v2/tracing/client-side-evals"},{"title":"Configuration","href":"/v2/tracing/configuration-details"},{"title":"User Properties","href":"/v2/tracing/setting-user-properties"},{"title":"Online Experiments","href":"/v2/tracing/online-experimentation"}]},{"group":"Advanced Features","pages":[{"title":"How to Set Up Distributed Tracing","sidebarTitle":"Distributed Tracing","href":"/v2/tracing/distributed-tracing"},{"title":"How to Trace MCP Servers and Clients","sidebarTitle":"MCP (Model Context Protocol)","href":"/v2/tracing/mcp-tracing"},{"title":"Multi-Instance Tracing","href":"/v2/tracing/multi-instance"},{"title":"Multi-Provider Tracing","href":"/v2/tracing/multi-provider"},{"title":"Multi-Modal Tracing","href":"/v2/tracing/multi-modal"},{"title":"Multi-Threading (Python)","href":"/v2/tracing/multithreading"},{"title":"Sampling","href":"/v2/tracing/sampling"},{"title":"Span Filtering","href":"/v2/tracing/filtering"},{"title":"Tracing via API","href":"/v2/tracing/manual-instrumentation"}]},{"group":"Explore Trace Data","pages":[{"title":"Explore in UI","href":"/v2/tracing/ui-flows"},{"title":"Tree View","href":"/v2/tracing/tree-view"},{"title":"Timeline View","href":"/v2/tracing/timeline-view"},{"title":"Graph View","href":"/v2/tracing/graph-view"},{"title":"Trajectory View","href":"/v2/tracing/trajectory-view"},{"title":"Thread View","href":"/v2/tracing/thread-view"},{"title":"How to troubleshoot Conversation view","sidebarTitle":"Conversation View Troubleshooting","href":"/v2/tracing/conversation-view-troubleshooting"},{"title":"Session Aggregations","href":"/v2/tracing/aggregation-logic"}]},{"title":"Export Data","href":"/v2/tracing/query-data"}]},{"group":"Monitoring","icon":"chart-line","pages":[{"title":"Monitor AI Application Performance in HoneyHive","sidebarTitle":"Dashboard","href":"/v2/monitoring/overview"},{"title":"Custom Charts","href":"/v2/monitoring/charts"},{"title":"Online Evaluations","href":"/v2/monitoring/onlineevals"}]},{"group":"Alerts","icon":"bell","pages":[{"title":"Overview","href":"/v2/monitoring/alerts/alerts_overview"},{"title":"Creating Alerts","href":"/v2/monitoring/alerts/alerts"}]}]},{"group":"Evaluation","pages":[{"group":"Experiments","icon":"clipboard-check","pages":[{"title":"AI Experiments and Evaluations in HoneyHive","sidebarTitle":"Introduction","href":"/v2/evaluation/introduction"},{"title":"Concepts","href":"/v2/evaluation/concepts"},{"title":"Comparing Experiments","href":"/v2/evaluation/comparing_evals"},{"title":"Sync Offline Evaluations","sidebarTitle":"Sync Offline Results","href":"/v2/evaluation/sync-offline-results"},{"title":"Experiments via API","href":"/v2/evaluation/via-api"},{"title":"CI Regression Detection","href":"/v2/evaluation/ci-regression-detection"}]},{"group":"Evaluators","icon":"user-check","pages":[{"title":"Introduction","href":"/v2/evaluators/introduction"},{"title":"Client-Side Evaluators","href":"/v2/evaluators/client_side"},{"group":"Server-Side Evaluators","pages":[{"title":"Python Evaluators","href":"/v2/evaluators/python"},{"title":"LLM Evaluators","href":"/v2/evaluators/llm"},{"group":"LLM Evaluation Providers","pages":[{"title":"Use Portkey for LLM Evaluators","href":"/v2/evaluators/portkey"}]},{"title":"Human Evaluators","href":"/v2/evaluators/human"},{"title":"Version Control","href":"/v2/evaluators/versioning"}]},{"title":"Evaluator Template List","href":"/v2/evaluators/evaluator-templates"}]},{"group":"Datasets","icon":"database","pages":[{"title":"Introduction","href":"/v2/datasets/introduction"},{"title":"Curate from Traces","href":"/v2/datasets/dataset-curation"},{"title":"Upload Datasets","href":"/v2/datasets/import"},{"title":"Run Experiments with HoneyHive Datasets","sidebarTitle":"Run with HoneyHive Datasets","href":"/v2/datasets/run-experiments"},{"title":"Sync from External Sources","href":"/v2/datasets/sync"},{"title":"Export Datasets","href":"/v2/datasets/export"},{"title":"Import from Hugging Face","href":"/v2/datasets/hf-datasets"}]},{"title":"Annotation Queues","icon":"user-check","href":"/v2/evaluation/annotation-queues"}]},{"group":"Prompt Management","pages":[{"title":"Managing Prompts","icon":"comment-dots","href":"/v2/prompts/overview"},{"title":"Using Prompts in Code","icon":"rocket","href":"/v2/prompts/deploy"}]},{"group":"Administration","pages":[{"group":"Organization","icon":"building","pages":[{"title":"Organization Hierarchy","icon":"sitemap","href":"/v2/workspace/organization-hierarchy"},{"title":"Managing Projects","icon":"boxes-stacked","href":"/v2/workspace/projects"},{"title":"Inviting Teammates","icon":"user-plus","href":"/v2/workspace/inviting-teammates"},{"title":"Role Based Access Control","icon":"user-shield","href":"/v2/workspace/roles"},{"title":"API Keys","icon":"key","href":"/v2/workspace/api-keys"},{"title":"How to create API keys programmatically","sidebarTitle":"Programmatic key creation","icon":"key","href":"/v2/workspace/api-keys/create-keys-programmatically"},{"title":"Identity Provider","icon":"user-lock","href":"/v2/workspace/identity-provider"},{"title":"Enterprise SSO on Multi-Tenant SaaS","icon":"id-badge","href":"/v2/workspace/enterprise-sso"},{"title":"SSO Group Role Mapping","description":"Assign HoneyHive roles and memberships from identity provider group claims, including claim requirements, the group naming grammar, and how to customize role assignment.","icon":"users-gear","href":"/v2/workspace/sso-group-role-mapping"},{"title":"Provider Keys","icon":"key","href":"/v2/workspace/provider-keys"},{"title":"Templates","description":"Configure standard evaluators and monitoring charts as org-wide templates so every HoneyHive project inherits baseline evaluators, charts, and dashboards.","icon":"clone","href":"/v2/workspace/templates"},{"title":"Usage","href":"/v2/workspace/usage"}]},{"group":"Hosting Options","icon":"cloud","pages":[{"title":"Multi-Tenant SaaS","icon":"globe","href":"/v2/setup/managed"},{"title":"Dedicated Cloud","icon":"lock","href":"/v2/setup/dedicated"},{"group":"Self-Hosted","icon":"warehouse","pages":[{"title":"Self-Hosting Overview","sidebarTitle":"Overview","icon":"warehouse","href":"/v2/setup/self-hosted"},{"title":"Security Architecture","icon":"shield-halved","href":"/v2/setup/self-hosted/security"},{"title":"Data Flow \u0026 Residency","icon":"arrows-split-up-and-left","href":"/v2/setup/self-hosted/data-flow"},{"title":"Operations Guide","icon":"screwdriver-wrench","href":"/v2/setup/self-hosted/operations"},{"title":"Application Metrics","icon":"chart-line","href":"/v2/setup/self-hosted/metrics"},{"title":"Infrastructure Requirements","icon":"cubes","href":"/v2/setup/infrastructure-requirements"}]}]},{"title":"HoneyHive Platform Architecture","sidebarTitle":"Platform Architecture","icon":"server","href":"/v2/platform-architecture"},{"title":"Security","icon":"shield-halved","href":"/v2/setup/security"}]},{"group":"Learn More","pages":[{"title":"HoneyHive Platform Concepts","sidebarTitle":"Overview","icon":"lightbulb","href":"/v2/concepts"},{"group":"Tutorials","icon":"play","expanded":false,"pages":[{"title":"End-to-End: Multi-Agent Tracing and Evaluation","icon":"book-open","href":"/v2/tutorials/multi-agent-cookbook"},{"title":"Add Tracing to Existing Apps","icon":"bolt","href":"/v2/tutorials/add-tracing-5min"},{"title":"Enrich Your Traces","icon":"sparkles","href":"/v2/tutorials/enriching-traces"},{"title":"Deploy Tracing to Production","icon":"rocket","href":"/v2/tutorials/production-deployment"},{"title":"Trace Distributed Systems","icon":"diagram-project","href":"/v2/tutorials/distributed-tracing"}]}]}]},{"tab":"SDK Reference","icon":"layer-group","pages":[{"title":"SDK Reference","href":"/v2/sdk-reference/overview"}]},{"tab":"CLI Reference","icon":"terminal","pages":[{"title":"CLI Reference","href":"/v2/cli-reference/getting-started"}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/v2/api-reference-autogen/sessions/start-a-new-session"}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/v2/integrations/overview"}]},{"tab":"Cookbooks","icon":"utensils","href":"https://github.com/honeyhiveai/cookbook"},{"tab":"Changelog","icon":"megaphone","pages":[{"title":"Changelog","href":"/v2/changelog/product"}]}]},{"product":"v1 (legacy)","icon":"server","description":"Deprecating Nov 5, 2026.","pages":[{"title":"v1 (legacy)","href":"/introduction/what-is-hhai"}]}]},"basePath":"","title":"Provider Keys - HoneyHive AI Docs","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-5Xwp92K7.js","DynamicMarkdown-BoyYAA8K.js","zoom-image-lightbox-DkE6VzSN.js","lightbox-handle-r17bVUz3.js"]}