# 프로바이더 URL: /ko/docs/providers 자신의 키를 가져오고, 연결 마법사를 실행하고, 집을 바꿔도 동일한 에이전트 워크플로를 유지하세요. Spirit Agent는 BYOK입니다. 프로바이더 콘솔에서 키를 생성하고, Desktop 또는 CLI에 붙여넣으면 Spirit이 운영 체제 키링에 저장합니다. 집을 바꿔도 작업 공간을 열거나 편집을 승인하거나 에이전트를 실행하는 방식은 변경되지 않습니다. 연결 마법사는 Desktop에서 **설정 → 모델**이며, CLI에서는 `/model add` 또는 `spirit model add`입니다. 추가 필드는 해당 프로바이더가 필요로 할 때만 나타납니다. Spirit은 네 가지 전송 방식 중 하나로 프로바이더와 통신합니다. 마법사는 유형을 고정하거나 선택하게 합니다. | 전송 | 마법사 라벨 | 일반적인 사용 | | ------------------- | ---------------------------------- | ------------------------------------------------------------- | | `openai-compatible` | Chat Completions API | 대부분의 OpenAI 호환 엔드포인트 | | `open-responses` | Responses API / Open Responses API | OpenAI, Azure, Vercel AI Gateway, Hugging Face 및 선택적 게이트웨이 경로 | | `anthropic` | Messages API | Anthropic, MiniMax 및 선택적 Messages 호환 엔드포인트 | | `bedrock` | Amazon Bedrock | Amazon Bedrock 전용 | Google Gemini 및 Vertex AI는 항상 Chat Completions를 사용합니다. 프로필이 Responses 또는 Messages를 요청하면 Spirit은 `openai-compatible`로 대체합니다. 일부 집은 키 위에 두 번째 차원을 추가합니다: * **리전 사이트** — Moonshot AI, SiliconFlow, MiniMax (중국 / 국제); Alibaba (리전 + `workspaceId`); Tencent TokenHub (광저우 / 싱가포르) * **요금제 엔드포인트** — Alibaba Token Plan, StepFun Step Plan, Z.ai / Zhipu AI GLM Coding Plan * **클라우드 필드** — Bedrock 리전, Azure 리소스 이름, Cloudflare 계정 (및 선택적 게이트웨이), Vertex 프로젝트 / 위치 프로바이더에 이러한 항목이 없으면 마법사는 키 → 모델 가져오기 → 활성 채팅 모델 선택만으로 진행됩니다. Spirit은 모델 카탈로그를 가져오고 활성 채팅 모델을 지정할 수 있게 하며, 카탈로그가 해당 기능을 표시할 때 이미지 / 비디오 / 경량 채팅 슬롯도 지정할 수 있습니다. 추론 및 내장 웹 검색은 모델과 전송 방식을 따르며, 별도의 Spirit 토글을 사용하지 않습니다. ## 카탈로그 [#카탈로그] 연결 선택기에 표시되는 집들은 같은 순서로 나열됩니다. 각 섹션은 해당 집의 키, 전송 및 추가 필드입니다. 위의 Desktop 및 CLI 마법사는 모든 집에 동일합니다. ### OpenAI [#openai] [OpenAI 플랫폼](https://platform.openai.com/api-keys)에서 API 키를 생성하세요. Spirit은 OpenAI 사용량을 판매하지 않습니다. 마법사는 **Responses API** (`open-responses`)를 고정합니다. 전송 선택기가 없습니다. 기본 베이스: `https://api.openai.com/v1`. 가져온 후 채팅하세요. 추론은 모델을 따릅니다. 이미지 및 비디오 생성은 카탈로그가 해당 기능을 표시할 때만 나타납니다 — 이미지 / 비디오 모델 슬롯에 지정하세요. ### Anthropic [#anthropic] [Anthropic 콘솔](https://console.anthropic.com/settings/keys)에서 API 키를 생성하세요. 고정 **Messages API** (`anthropic`). 기본 베이스: `https://api.anthropic.com/v1`. 가져온 후 채팅하세요. 추론은 모델을 따릅니다. 나중에 카탈로그 항목이 표시하지 않는 한 Spirit 측 이미지 또는 비디오 생성 슬롯이 없습니다. ### Google [#google] [Google AI Studio](https://aistudio.google.com/apikey)에서 API 키를 생성하세요. 고정 **Chat Completions API** (`openai-compatible`). Responses 또는 Messages를 요청하면 Chat Completions로 대체됩니다. 기본 베이스: `https://generativelanguage.googleapis.com/v1beta`. 가져온 후 채팅하세요. 이미지 생성은 카탈로그가 표시할 때만 지정됩니다. Vertex AI (GCP 프로젝트 / 위치)의 경우 [Google Vertex AI](#google-vertex-ai)를 사용하세요. ### SpaceXAI [#spacexai] [SpaceXAI 콘솔](https://console.x.ai/team/default/api-keys)에서 API 키를 생성하세요. 고정 **Chat Completions API** (`openai-compatible`). 기본 베이스: `https://api.x.ai/v1`. 가져오기 후 채팅. 추론, 이미지 및 비디오는 가져온 카탈로그를 따르며, 나타날 때 슬롯을 할당합니다. ### Vercel AI Gateway [#vercel-ai-gateway] [Vercel AI Gateway](https://vercel.com/docs/ai-gateway) 대시보드에서 키를 생성하세요. 고정 **Open Responses API** (`open-responses`). 기본 베이스: `https://ai-gateway.vercel.sh/v1`. 채팅 및 게이트웨이 카탈로그가 노출하는 모든 것. 이미지 생성은 태그가 아닌 카탈로그 `type=image`에서 가져옵니다. 태그에서 비전이나 이미지 생성을 추론하지 마십시오. 이 게이트웨이를 통한 MiniMax M3는 Open Responses에서 표시 가능한 사고 스트림을 반환하지 않습니다. ### Cloudflare AI Gateway [#cloudflare-ai-gateway] [Cloudflare 대시보드](https://developers.cloudflare.com/ai-gateway/)에서 API 토큰을 생성하세요. 계정 ID도 필요합니다. 선택기: **Chat Completions**, **Open Responses** 또는 **Messages**. 베이스는 계정에서 빌드됩니다: `https://api.cloudflare.com/client/v4/accounts/{accountId}/ai/v1`. * **계정 ID** (필수) — 32자리 16진수 * **게이트웨이 ID** (선택) 계정 ID 없이는 마법사가 API 베이스를 빌드할 수 없습니다. 채팅 및 기타 기능은 게이트웨이가 노출하는 모델을 따릅니다. ### DeepSeek [#deepseek] [DeepSeek 플랫폼](https://platform.deepseek.com/api-keys)에서 API 키를 생성하세요. 선택기 없음. 연결 기본값은 **Open Responses** (`open-responses`)입니다. 호환 가능한 베이스는 `https://api.deepseek.com/v1` (Chat) 및 `https://api.deepseek.com/anthropic` (Messages)에도 있습니다. 가져오기 후 채팅. 추론은 모델을 따릅니다. ### OpenRouter [#openrouter] [OpenRouter](https://openrouter.ai/keys)에서 키를 생성하세요. 선택기: **Chat Completions**, **Open Responses** 또는 **Messages**. 기본 베이스: `https://openrouter.ai/api/v1`. 채팅 및 OpenRouter가 해당 모델을 노출할 때 카탈로그에 표시된 이미지 또는 비디오 생성. ### Fireworks AI [#fireworks-ai] [Fireworks 콘솔](https://app.fireworks.ai/settings/users/api-keys)에서 API 키를 생성하세요. 선택기: **Chat Completions**, **Messages** 또는 **Open Responses**. Chat/Responses 베이스: `https://api.fireworks.ai/inference/v1`. Messages 베이스: `https://api.fireworks.ai/inference`. 가져오기 후 채팅. 기타 기능은 Fireworks 카탈로그를 따릅니다. ### Together AI [#together-ai] [Together AI 콘솔](https://api.together.ai/settings/api-keys)에서 API 키를 생성하세요. 고정 **Chat Completions API**. 기본 베이스: `https://api.together.ai/v1`. 가져오기 후 채팅. 카탈로그가 표시할 때만 이미지 또는 비디오 슬롯을 할당하세요. ### Groq [#groq] [Groq 콘솔](https://console.groq.com)에서 API 키를 생성하세요. 고정 **Chat Completions API**. 기본 베이스: `https://api.groq.com/openai/v1`. 가져오기 후 채팅. Groq가 노출할 때 추론은 모델을 따릅니다. ### DeepInfra [#deepinfra] [DeepInfra 대시보드](https://deepinfra.com/dash/keys)에서 API 키를 생성하세요. 고정 **Chat Completions API**. 기본 베이스: `https://api.deepinfra.com/v1/openai`. 가져오기 후 채팅. 기타 기능은 카탈로그를 따릅니다. ### Baseten [#baseten] [Baseten 콘솔](https://app.baseten.co/settings/api_keys)에서 API 키를 생성하세요. 고정 **Chat Completions API**. 기본 베이스: `https://inference.baseten.co/v1`. 가져오기 후 채팅. 기타 기능은 카탈로그를 따릅니다. ### Hugging Face [#hugging-face] [Hugging Face 설정](https://huggingface.co/settings/tokens)에서 토큰을 생성하세요. **Open Responses API**로 고정됩니다. 기본 베이스: `https://router.huggingface.co/v1`. 가져온 후 채팅하세요. 그 외 기능은 라우터 카탈로그를 따릅니다. ### Moonshot AI [#moonshot-ai] 사용할 사이트의 Moonshot 콘솔에서 API 키를 생성하세요: [중국](https://platform.kimi.com/console/api-keys) 또는 [국제](https://platform.kimi.ai/console/api-keys). **Chat Completions API**로 고정됩니다. 전송 선택기가 없습니다. * **국제**(기본값) — `https://api.moonshot.ai/v1` * **중국** — `https://api.moonshot.cn/v1` 이것은 Moonshot Open Platform 공급자이며 [Kimi Code](#kimi-code)가 아닙니다. moonshot-ai의 기본 제공 검색은 Kimi Code 호스팅 검색 경로를 사용하지 않습니다. Kimi Code 키와 Moonshot Open Platform 키는 서로 다른 연결입니다. ### Kimi Code [#kimi-code] [Kimi Code 콘솔](https://www.kimi.com/code/console)에서 Kimi Code API 키를 생성하세요. **Chat Completions API**로 고정됩니다. 기본 베이스: `https://api.kimi.com/coding/v1`. `https://api.kimi.com/coding`에 Messages 베이스가 있지만 마법사는 선택기를 제공하지 않습니다. 가져온 후 채팅하세요. 호스팅 검색은 사용 가능한 경우 이 공급자(다른 moonshot-ai가 아님)에 한정됩니다. ### Z.ai [#zai] [Z.ai 콘솔](https://z.ai/manage-apikey/apikey-list)에서 API 키를 생성하세요. 코딩 플랜 참고: [GLM 코딩 플랜](https://docs.z.ai/devpack/quick-start). **Chat Completions API**로 고정됩니다. 기본 베이스: `https://api.z.ai/api/paas/v4`. 마법사에서 **GLM 코딩 플랜**을 켜면 기본 PaaS 베이스 대신 `https://api.z.ai/api/coding/paas/v4`를 사용합니다. 가져온 후 채팅하세요. 추론은 모델을 따릅니다. ### Zhipu AI [#zhipu-ai] [Zhipu AI 콘솔](https://bigmodel.cn/console)에서 API 키를 생성하세요. 코딩 플랜 참고: [GLM 코딩 플랜](https://docs.bigmodel.cn/cn/coding-plan/quick-start). **Chat Completions API**로 고정됩니다. 기본 베이스: `https://open.bigmodel.cn/api/paas/v4`. **GLM 코딩 플랜**을 켜면 `https://open.bigmodel.cn/api/coding/paas/v4`를 사용합니다. 가져온 후 채팅하세요. 추론은 모델을 따릅니다. ### Alibaba [#alibaba] [Alibaba Cloud Model Studio / Bailian](https://bailian.console.aliyun.com)에서 API 키를 생성하세요. **Chat Completions API**로 고정됩니다. 호환 기본값: `https://dashscope.aliyuncs.com/compatible-mode/v1`. * **cn-beijing**(기본값) — `https://{workspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` (workspace id 필수) * **ap-southeast-1** — workspace id 필수 * **us-virginia** — `https://dashscope-us.aliyuncs.com/compatible-mode/v1` (workspace id 불필요) * **eu-central-1** — workspace id 필수 **토큰 플랜**은 `https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`로 전환되며 사이트/워크스페이스를 무시합니다. 참고: [토큰 플랜](https://bailian.console.aliyun.com/cn-beijing?tab=doc#/doc/?type=model\&url=3029020). 토큰 플랜은 다른 사이트를 선택했더라도 항상 cn-beijing 플랜 엔드포인트를 사용합니다. 가져온 후 채팅하세요. 그 외 기능은 카탈로그를 따릅니다. ### MiniMax [#minimax] 사용할 사이트의 MiniMax 콘솔에서 API 키를 생성하세요: [중국](https://platform.minimaxi.com/console/) 또는 [국제](https://platform.minimax.io/console/). **Messages API**(`anthropic`)로 고정됩니다. 국제 Messages 베이스: `https://api.minimax.io/anthropic/v1`. * **국제**(기본값) — `https://api.minimax.io/v1` (Chat 형태) / `https://api.minimax.io/anthropic/v1` (Messages) * **중국** — `https://api.minimaxi.com/v1` 가져온 후 채팅하세요. 업스트림 `/models` 목록에는 멀티모달 플래그가 없습니다. M3만 이미지/비디오 입력을 지원하는 것으로 처리됩니다. Vercel AI Gateway를 통한 Open Responses에서 MiniMax M3는 표시 가능한 thinking 스트림을 반환하지 않습니다. ### Xiaomi [#xiaomi] [Xiaomi MiMo 콘솔](https://platform.xiaomimimo.com/console/api-keys)에서 API 키를 생성하세요. 고정됨 **Chat Completions API**. 기본 베이스: `https://api.xiaomimimo.com/v1`. 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### SiliconFlow [#siliconflow] 사용할 사이트의 SiliconFlow 콘솔에서 API 키를 생성하세요: [국제](https://cloud.siliconflow.com/me/account/ak) 또는 [중국](https://cloud.siliconflow.cn/me/account/ak). 선택기: **Chat Completions** 또는 **Messages**. * **국제** (기본) — `https://api.siliconflow.com/v1` * **중국** — `https://api.siliconflow.cn/v1` 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### StepFun [#stepfun] [StepFun 플랫폼](https://platform.stepfun.com)에서 API 키를 생성하세요. Step Plan 참고: [Step Plan](https://platform.stepfun.com/docs/zh/step-plan/integrations/reasoning-api). 고정됨 **Chat Completions API**. 기본 베이스: `https://api.stepfun.com/v1`. **Step Plan**은 `https://api.stepfun.com/step_plan/v1`로 전환됩니다. 가져온 후 채팅하세요. 추론은 모델을 따릅니다. ### Volcengine [#volcengine] [Volcengine Ark 콘솔](https://console.volcengine.com/ark/apiKey)에서 API 키를 생성하세요. 선택기: **Chat Completions** 또는 **Responses API**. 기본 베이스: `https://ark.cn-beijing.volces.com/api/v3`. 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### BytePlus [#byteplus] [BytePlus Ark 콘솔](https://console.byteplus.com/ark/apiKey)에서 API 키를 생성하세요. 선택기: **Chat Completions** 또는 **Responses API**. 기본 베이스: `https://ark.ap-southeast.bytepluses.com/api/v3`. 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### Meituan [#meituan] [LongCat 콘솔](https://longcat.chat/platform/api_keys)에서 API 키를 생성하세요. 고정됨 **Chat Completions API**. 기본 베이스: `https://api.longcat.chat/openai/v1`. 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### Tencent TokenHub [#tencent-tokenhub] [Tencent TokenHub 콘솔](https://console.cloud.tencent.com/tokenhub)에서 API 키를 생성하세요. 고정됨 **Chat Completions API**. 마법사는 Responses 또는 Messages를 제공하지 않습니다. * **광저우** (기본) — `https://tokenhub.tencentmaas.com/v1` * **싱가포르** — `https://tokenhub-intl.tencentmaas.com/v1` 가져온 후 채팅하세요. 채팅에 주입된 웹 검색에 의존하지 마세요. TokenHub는 Chat `web_search_options` 및 Responses `web_search`를 문서화하지만, 실제로 Chat 주입은 작동하지 않으며 Responses는 일부 모델에서만 사용할 수 있습니다. 따라서 Spirit은 Chat Completions만 유지합니다. ### Mistral [#mistral] [Mistral 콘솔](https://console.mistral.ai)에서 API 키를 생성하세요. 고정됨 **Chat Completions API**. 기본 베이스: `https://api.mistral.ai/v1`. 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### Cohere [#cohere] [Cohere 대시보드](https://dashboard.cohere.com)에서 API 키를 생성하세요. 고정됨 **Chat Completions API**. 기본 베이스: `https://api.cohere.com/v2`. 가져온 후 채팅하세요. 기타 기능은 카탈로그를 따릅니다. ### Azure [#azure] [Azure 포털](https://portal.azure.com)에서 Azure OpenAI 리소스용 키를 생성하세요. 고정 **Responses API** (`open-responses`). 전송 선택기가 없습니다. * **리소스 이름** (필수) — 2–64자, 문자, 숫자 및 하이픈; 하이픈으로 시작하거나 끝날 수 없음 Spirit은 `https://{resource}.openai.azure.com/openai/v1`을 구성합니다. 가져온 후 채팅합니다. 표시된 경우 이미지 생성은 Azure 카탈로그를 따릅니다. ### Amazon Bedrock [#amazon-bedrock] [AWS Bedrock 콘솔](https://console.aws.amazon.com/bedrock)에서 Bedrock을 호출할 수 있는 Bearer API 키 또는 IAM 사용자를 생성합니다. 고정 **Amazon Bedrock** (`bedrock`). 기본 호스트 형태: `https://bedrock.us-east-1.amazonaws.com`. * **AWS 리전** (필수), 예: `us-east-1` * **인증**: **Bearer** 또는 **IAM** * Bearer — Bedrock API 키와 모델 ID를 붙여넣습니다. 모델은 자동으로 가져오지 **않습니다**. * IAM — 액세스 키 ID + 비밀 액세스 키. Spirit이 계정에서 기반 모델을 나열합니다. 모델을 선택한 후 채팅합니다. 다른 기능은 해당 모델을 따릅니다. Bearer 키는 추론에만 작동합니다. `ListFoundationModels`는 Bearer를 허용하지 않으므로 카탈로그 가져오기에는 IAM이 필요합니다. ### Google Vertex AI [#google-vertex-ai] Vertex AI가 활성화된 GCP 프로젝트를 사용하세요. 인증은 ADC, 서비스 계정 또는 Express API 키입니다 — 일반 OpenAI 키가 아닙니다. 고정 **Chat Completions API**. Responses 또는 Messages 요청은 Chat Completions로 대체됩니다. Base는 `https://{location}-aiplatform.googleapis.com/v1/projects/{project}/locations/{location}`이 됩니다. * **GCP 프로젝트 ID** 및 **위치** (필수), 예: `us-central1` * **인증** * **ADC** — 이 머신의 애플리케이션 기본 자격 증명 (`GOOGLE_APPLICATION_CREDENTIALS`) * **서비스 계정** — 클라이언트 이메일 + 개인 키; 모델 목록을 가져오는 데 사용 * **Express API 키** — 카탈로그를 가져올 수 없음; 모델 ID를 수동으로 추가 모델을 선택한 후 채팅합니다. GCP 프로젝트가 없는 AI Studio 키의 경우 [Google](#google)을 사용하세요. Express 모드는 모델 목록을 가져올 수 없습니다. 서비스 계정 모드는 모델을 나열하려면 이메일과 개인 키가 모두 필요합니다. ### 사용자 지정 [#사용자-지정] 엔드포인트가 기대하는 API 키를 사용하세요. Spirit 호스팅 사용자 지정 공급자는 없습니다. 선택기: **Chat Completions**, **Open Responses** 또는 **Messages**. **Base URL**을 제공해야 합니다. 비워 두면 기본값은 `https://api.openai.com/v1`입니다. 공급업체가 문서화한 루트를 입력하세요. 필요한 경우 버전 접미사 (`/v1`, `/v1/openai`, …)를 포함하세요. Spirit은 사용자 지정 엔드포인트에 대해 경로를 추측하지 않습니다. 공급자 그룹에 표시 이름을 설정하여 여러 사용자 지정 엔드포인트를 구분할 수도 있습니다. 연결 후 모델 ID를 가져오거나 입력하세요. 엔드포인트가 Spirit이 이해하는 카탈로그를 게시하지 않는 경우 마법사에서 채팅 / 이미지 / 비디오 기능을 표시하세요.