export AILOOT_API_KEY="sk-..."
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
claude
모델 예제: claude-sonnet-5-5
중요
/v1을 제외한 주소를 사용하세요. Claude Code가 /v1/messages를 추가합니다. ANTHROPIC_AUTH_TOKEN은 Authorization: Bearer로, ANTHROPIC_API_KEY는 x-api-key로 전송하며 Ailoot는 둘 다 허용합니다. CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1은 /v1/models에서 Ailoot 모델을 /model로 가져옵니다. 알 수 없는 필드의 400 오류에는 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1을 사용합니다. Anthropic 문서는 게이트웨이를 통한 비Claude 모델 사용을 지원하지 않습니다. Ailoot의 /v1/messages가 이 모델들을 처리하더라도 Claude 모델을 권장합니다. 게이트웨이에서는 Remote Control과 음성 입력을 사용할 수 없습니다.
~/.codex/config.toml(사용자 파일만 허용. 프로젝트 .codex/config.toml의 model_provider/model_providers는 무시됨); 키 — env_key에 지정한 환경 변수
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "ailoot"
[model_providers.ailoot]
name = "Ailoot"
base_url = "https://api.ailoot.ai/v1"
env_key = "AILOOT_API_KEY"
wire_api = "responses"
export AILOOT_API_KEY="sk-..."
codex
모델 예제: gpt-6.1-sol
중요
Codex는 OpenAI Responses API만 사용합니다(문서에는 wire_api = "responses"만 명시). 따라서 /v1/responses가 필요합니다. 제공자 ID openai, ollama, lmstudio는 예약되어 있습니다. 다른 방법은 내장 openai의 openai_base_url = "https://api.ailoot.ai/v1"입니다. Ailoot는 Codex manifest 형식의 목록(GET /v1/models에 client_version을 포함한 요청)을 제공합니다. 카탈로그에서 OpenAI Responses가 있는 구체적 모델을 선택하세요. 2026-09-30 스냅샷의 gemini-3.6-flash는 OpenAI Chat, Anthropic Messages, Gemini만 있고 Responses가 없으므로 Codex에 맞지 않습니다. 모델군 이름이 아니라 각 카드에서 형식을 확인하세요.
hermes model → «Custom endpoint (self-hosted / VLLM / etc.)» 또는 ~/.hermes/config.yaml(model 섹션 또는 providers 사전)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
~/.hermes/config.yaml
model:
default: claude-sonnet-5-5
provider: custom
base_url: https://api.ailoot.ai/v1
key_env: AILOOT_API_KEY
# 여러 형식을 함께 사용하려면 이름을 지정한 공급자를 설정하세요:
providers:
ailoot:
api: https://api.ailoot.ai/v1
key_env: AILOOT_API_KEY
transport: chat_completions
default_model: gpt-6.1-sol
ailoot-claude:
api: https://api.ailoot.ai
key_env: AILOOT_API_KEY
transport: anthropic_messages
default_model: claude-sonnet-5-5
# 세션에서: /model custom:claude-sonnet-5-5
키를 읽어 오는 환경 변수: AILOOT_API_KEY — 실행 전에 설정하세요:
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: claude-sonnet-5-5
중요
transport: chat_completions(OpenAI Chat), anthropic_messages(Anthropic Messages), codex_responses(OpenAI Responses). .env의 LLM_MODEL은 더 이상 사용하지 않으며 OPENAI_BASE_URL은 openai-api 제공자에만 적용됩니다. anthropic_messages는 /v1을 제외하세요. Anthropic SDK가 /v1/messages를 추가합니다. 이미지 인식·대화 압축 등 보조 작업도 기본적으로 같은 주 모델을 사용합니다.
OpenClaw 설정(~/.openclaw/openclaw.json) → models.providers.<id>; 기본 모델 — agents.defaults.model.primary; 안전한 수정 — openclaw config set models.providers.<id> '<json>' --strict-json --merge
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: claude-sonnet-5-5
중요
api 어댑터: openai-completions(baseUrl 지정 시 기본값), openai-responses(서버가 /v1/responses를 지원할 때만 사용하며 Ailoot는 지원), anthropic-messages, google-generative-ai 등. anthropic-messages 예제는 /v1 없는 baseUrl을 사용합니다. 모델 input에 "image"가 있으면 OpenClaw가 이미지를 보냅니다. Claude 예제는 텍스트만 유지합니다. 2026-09-30 스냅샷의 해당 메서드는 image 입력을 명시하지 않습니다. 현재 카드가 선택한 API 형식과 이미지 입력을 명시한 구체적 모델에만 "image"를 추가하세요. 예를 들어 스냅샷의 gemini-3.6-flash는 OpenAI Chat image 입력을 명시하지만 실제 지원은 카드와 형식에 달려 있습니다. 주 설정 경로는 일반 OpenClaw 사용 관례에 따랐으며 읽은 문서는 ~/.openclaw/agents/<agentId>/agent/models.json도 언급합니다.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: claude-sonnet-5-5
중요
@ai-sdk/openai-compatible은 /v1/chat/completions를 사용합니다. /v1/responses가 필요한 모델은 문서의 @ai-sdk/openai를 사용하세요. 자체 baseURL이 있는 Anthropic 호환 제공자는 opencode 문서에 없습니다. 현재 카탈로그가 OpenAI Chat을 명시한 모델을 선택하세요. 2026-09-30의 gemini-3.6-flash는 지원하지만 다른 Gemini는 각 카드를 확인해야 합니다. 이 경로는 네이티브 Gemini 형식을 쓰지 않습니다. 카탈로그에 메서드가 있다고 특정 클라이언트 버전의 실제 실행을 증명하지는 않습니다.
OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL 변수, 세션의 /auth 명령 또는 ~/.qwen/settings.json(modelProviders + security.auth.selectedType)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..."
# 빠른 설정
export OPENAI_API_KEY="$AILOOT_API_KEY"
export OPENAI_BASE_URL=https://api.ailoot.ai/v1
export OPENAI_MODEL=qwen3.8-max
qwen
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: qwen3.8-max
중요
프로토콜 타입: openai(Chat Completions), anthropic, gemini, vertex-ai. openai의 baseUrl에는 /v1을 포함합니다. 문서의 anthropic·gemini 예제에는 baseUrl이 없으므로 openai 방식을 권장합니다. OpenAI Chat을 지원하는 카탈로그 모델을 선택하세요. gemini-3.6-flash는 지원하지만 다른 Gemini 모델은 지원 형식이 다를 수 있어 각 카드를 확인해야 합니다. settings.json은 envKey의 AILOOT_API_KEY에서 키를 읽습니다. export AILOOT_API_KEY=sk-... 또는 ~/.qwen/.env의 AILOOT_API_KEY=sk-...로 지정하세요. 그렇지 않으면 빈 키로 시작해 401을 받습니다.
환경 변수 GEMINI_API_KEY 및 GOOGLE_GEMINI_BASE_URL; 인증 방식 — ~/.gemini/settings.json → security.auth.selectedType = "gemini-api-key"; 모델 — GEMINI_MODEL 또는 -m 플래그
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
주소에는 /v1beta를 넣지 마세요. SDK가 /v1beta/models/{model}:generateContent를 자동으로 추가합니다. 주소는 HTTPS여야 합니다. 키는 x-goog-api-key 헤더로 전송되며 Ailoot가 이를 받습니다. 카탈로그에 Gemini 형식이 명시된 모델만 사용할 수 있습니다. 실행 전에 정확한 ID와 이 메서드가 해당 키에 제공되는지 확인하세요. Ailoot는 비용 계산 후 유료 Gemini 응답을 단어별이 아닌 전체 응답으로 전달하므로, 긴 응답의 텍스트는 즉시 표시되지 않습니다.
~/.kimi/config.toml(providers 및 models 섹션, default_model); /login은 Moonshot 플랫폼만 지원하므로 사용자 주소는 파일에 직접 지정
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
crushrc(Bash 설정): ./.crushrc, ./crushrc 또는 ~/.config/crush/crushrc; 이전 crush.json 형식은 구식이지만 동작함
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: deepseek-v4-pro
중요
openai-compat 타입은 OpenAI Chat 형식이며 /v1을 포함합니다. anthropic 타입은 Messages 형식이며 /v1을 제외합니다. Crush가 주소를 anthropic-sdk-go에 전달하면 /v1/messages가 자동 추가됩니다. Crush README의 /v1 예제는 /v1/v1/messages가 되어 404 오류를 일으킵니다. 키는 x-api-key로 보내며 Ailoot가 허용합니다. 모델 목록이 비면 openai-compat가 /v1/models에서 자동 조회합니다. crushrc는 코드로 실행되므로 다른 사람의 폴더에 이 파일이 있다면 Crush를 시작하지 마세요. 예제 Claude는 supports-images = false입니다. 2026-09-30 스냅샷은 선택한 Messages 형식에 텍스트만 명시합니다. 버전이 이 플래그를 지원해도 현재 카드가 해당 API 형식의 image 입력을 명시한 모델에서만 켜세요. 클라이언트 플래그가 모델에 이미지 지원을 추가하지는 않습니다.
openai/ 접두사는 필수입니다. Aider가 LiteLLM을 통해 OpenAI 호환 /v1/chat/completions로 요청을 보내게 합니다. Aider가 모르는 모델은 컨텍스트 정보가 없다는 경고를 표시하지만 오류가 아닙니다. 자체 base URL을 사용하는 Anthropic 주소는 이 문서 페이지에 설명되어 있지 않습니다.
goose configure → Custom Providers → Add A Custom Provider 또는 ~/.config/goose/custom_providers/의 JSON(Windows: %APPDATA%\Block\goose\config\custom_providers\); 다른 방법 — OPENAI_HOST/OPENAI_BASE_PATH를 사용하는 내장 OpenAI 제공자
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
사용자 지정 제공자 엔진: openai, anthropic, ollama. Goose 예제의 engine openai base_url은 /v1/chat/completions까지의 전체 경로입니다. 내장 제공자의 OPENAI_HOST는 경로 없는 루트, OPENAI_BASE_PATH는 경로(기본값 v1/chat/completions)입니다. Goose는 config.yaml의 키를 무시하므로 환경 변수 또는 키체인을 사용하세요. 저장소는 aaif-goose/goose로 이동했습니다.
~/.factory/settings.json → customModels 배열; 모델 선택 — /model 명령의 «Custom models» 메뉴
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
설정 → Model Routing → Add → Custom URL(팀은 workspace Model Routing); 터미널 — amp config model-providers (list, test, set-priority, edit-router…)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Model Routing → Add → Custom URL
Format: anthropic-messages
Base URL: https://api.ailoot.ai
API key: sk-...
Model mapping:
anthropic/claude-fable-5 -> anthropic/claude-fable-5
GPT용 두 번째 연결:
Format: responses
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Model mapping:
openai/gpt-5.6-sol -> gpt-5.6-sol
확인: amp config model-providers check-access --provider-model anthropic/claude-fable-5
모델 예제: claude-fable-5
중요
Custom URL 형식: chat-completions(<base>/chat/completions), responses(<base>/responses), anthropic-messages(<base>/v1/messages, /v1 중복 없음), google-genai(<base>/models/<model>:streamGenerateContent). 키는 Authorization: Bearer로 전송합니다. 매핑에는 provider/model 형식의 Amp 표준 ID를 사용하며 화살표는 Ailoot로 전달할 ID를 지정합니다. 연결 범위에 없는 모델은 Amp가 자체 크레딧으로 처리합니다. 문서는 사용자 지정 호스트가 Amp에서 접근 가능해야 한다고 요구합니다. 주소가 공개되어 있어 조건을 만족합니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
환경 변수 COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY, COPILOT_MODEL(또는 --model 플래그)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..."
unset COPILOT_PROVIDER_TYPE
# OpenAI 호환 모드
export COPILOT_PROVIDER_BASE_URL=https://api.ailoot.ai/v1
export COPILOT_PROVIDER_API_KEY="$AILOOT_API_KEY"
export COPILOT_MODEL=gpt-6.1-sol
copilot
# Anthropic 모드
export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://api.ailoot.ai
export COPILOT_PROVIDER_API_KEY="$AILOOT_API_KEY"
export COPILOT_MODEL=claude-sonnet-5-5
copilot
모델 예제: gpt-6.1-sol
중요
타입: openai(기본값, 모든 OpenAI 호환 서버), azure, anthropic. 도구 호출과 스트리밍을 지원하는 모델이어야 합니다. COPILOT_PROVIDER_WIRE_API로 프로토콜을 선택하지만 값은 페이지에 명시되어 있지 않습니다. COPILOT_PROVIDER_MAX_PROMPT_TOKENS / MAX_OUTPUT_TOKENS로 한도를 설정할 수 있습니다.
~/.config/kilo/kilo.jsonc(또는 ./kilo.jsonc, KILO_CONFIG도 사용 가능) → provider.<id>.options.baseURL; 확장 — Settings → Providers → Custom provider
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: claude-sonnet-5-5
중요
Custom provider 창에서 OpenAI Compatible(Chat Completions), OpenAI Responses, Anthropic Messages를 선택할 수 있습니다. {env:VAR}는 신뢰된 전역 설정(~/.config/kilo)에서만 동작하며 프로젝트 kilo.json에서는 환경 변수의 키가 치환되지 않습니다.
llm 설정 폴더의 extra-openai-models.yaml; 키 — llm keys set <이름>
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
LiteLLM을 사용하며 model_kwargs를 litellm.completion에 직접 전달합니다. 가격 등록이 없으면 LiteLLM이 알 수 없는 비용으로 오류를 내므로 cost_tracking: "ignore_errors" 또는 MSWEA_COST_TRACKING=ignore_errors로 끕니다. OPENAI_API_KEY로 키를 보내는 것은 LiteLLM 표준이지만 mini-SWE-agent 페이지에는 표시되어 있지 않습니다.
Ctrl+P → Settings(제공자, 모델), ~/.openhands/agent_settings.json(llm.model / llm.api_key / llm.base_url) 또는 --override-with-envs 플래그와 함께 LLM_MODEL, LLM_API_KEY, LLM_BASE_URL 환경 변수 사용
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OpenHands는 LiteLLM을 사용합니다. OpenAI 프록시는 문서에 따라 openai/<모델> 형식의 Custom Model과 프록시 Base URL을 지정하세요. --override-with-envs 변경은 저장되지 않습니다. 웹 UI: Settings → LLM → Advanced → Custom Model, Base URL, API Key.
~/.pi/agent/models.json(또는 프로젝트를 신뢰한 후 .pi/models.json); 선택 — /model
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: claude-sonnet-5-5
중요
Pi 문서는 models.json의 OpenAI, Anthropic, Google 호환 endpoint를 명확히 허용하며 예제는 api: openai-completions입니다. apiKey는 $NAME/${NAME}, 리터럴 또는 !명령을 해석합니다. /model을 열면 파일을 다시 읽습니다.
trae_config.yaml → model_providers.<이름>.base_url; 다른 방법 — .env의 OPENAI_BASE_URL / ANTHROPIC_BASE_URL 변수
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Settings → «inference endpoint» 검색 → Custom inference endpoint: 기본 URL, 키, 모델 ID; 이후 선택기에서 모델 선택
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Settings → inference endpoint
Endpoint URL: https://api.ailoot.ai/v1
API key: sk-...
Models: claude-sonnet-5-5, gpt-6.1-sol, deepseek-v4-pro
그런 다음 모델 목록에서 claude-sonnet-5-5 등을 선택하세요 (Auto 제외).
모델 예제: claude-sonnet-5-5
중요
OpenAI Chat Completions(POST /v1/chat/completions)만 지원합니다. 요청은 Warp 서버를 통과합니다. 키는 로컬에 보관되지만 요청할 때마다 Warp 백엔드로 전달됩니다. Auto 및 사용자 라우터는 항상 Warp 크레딧을 사용하며 클라우드 에이전트는 이 endpoint를 사용하지 않습니다. Free 및 유료 개인·최대 10인 팀 요금제에서 사용할 수 있습니다. 현재 카탈로그가 OpenAI Chat을 명시한 모델을 선택하세요. 2026-09-30의 gemini-3.6-flash는 지원하지만 다른 Gemini는 각 카드를 확인해야 합니다. 네이티브 Gemini 형식은 이 경로를 쓰지 않습니다. 메서드가 있다고 특정 클라이언트 버전의 실제 실행을 증명하지는 않습니다.
Cline 패널 → 톱니바퀴(Settings) → API Provider = «OpenAI Compatible» → Base URL, API Key, Model ID. 다른 방법: API Provider = «Anthropic» → «Use custom base URL» 선택.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OpenAI Compatible (권장):
API Provider: OpenAI Compatible
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
Model ID: claude-sonnet-5-5 (또는 gpt-6.1-sol, deepseek-v4-pro, qwen3.8-max)
Model Configuration: Context Window 및 Max Output Tokens는 모델에 맞게 설정; Image Support는 이미지를 인식하는 모델에만 사용.
Anthropic (Messages):
API Provider: Anthropic
Anthropic API Key: sk-...
[x] Use custom base URL → https://api.ailoot.ai
모델 예제: claude-sonnet-5-5
중요
OpenAI Compatible은 /v1/chat/completions를 호출하므로 주소에 /v1을 포함합니다. Anthropic은 /v1/messages를 호출하며 주소에 /v1을 제외합니다. 다만 모델 목록에 Anthropic 이름만 있으므로 다른 Ailoot 모델은 OpenAI Compatible으로 사용합니다. 에이전트 모드는 도구 호출 모델이 필요합니다. Gemini 3.1 Pro는 chat/completions에서 사용할 수 없습니다(Gemini와 Anthropic 형식만 지원). 여기서는 gemini-3.6-flash를 사용하세요.
Roo Code 패널 → 톱니바퀴 → API Provider = «OpenAI Compatible» → Base URL, API Key, Model; 필요하면 Model Configuration(Max Output Tokens, Context Window, Image Support, Computer Use, 가격). Anthropic 제공자에는 «Use custom base URL» 체크박스가 있습니다.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
API Provider: OpenAI Compatible
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
Model: gpt-6.1-sol (또는 claude-sonnet-5-5, kimi-k3, glm-5.3)
Anthropic을 사용하는 방식:
API Provider: Anthropic, API key sk-..., [x] Use custom base URL → https://api.ailoot.ai
모델 예제: gpt-6.1-sol
중요
Roo Code는 OpenAI 형식의 도구만 호출하므로 모델이 /v1/chat/completions의 tools를 지원해야 합니다. Anthropic은 /v1/messages를 쓰며 주소에 /v1을 제외합니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
name: Ailoot
version: 0.0.1
schema: v1
models:
- name: Ailoot Claude Sonnet 5.5
provider: openai
model: claude-sonnet-5-5
apiBase: https://api.ailoot.ai/v1
apiKey: sk-...
- name: Ailoot GPT-6.1 Sol
provider: openai
model: gpt-6.1-sol
apiBase: https://api.ailoot.ai/v1
apiKey: sk-...
# useResponsesApi: false # /chat/completions를 반드시 사용해야 하는 경우에만 설정
모델 예제: claude-sonnet-5-5
중요
apiBase는 /v1로 끝나야 합니다. gpt-5/o 계열 이름이면 Continue가 /v1/responses를 자동 선택할 수 있습니다. Ailoot의 gpt-*는 /v1/responses와 /v1/chat/completions를 모두 지원하며 useResponsesApi: false는 chat/completions를 강제합니다. useLegacyCompletionsEndpoint는 필요하지 않습니다.
Agent Settings(agent::OpenSettings) → LLM Providers → Add Provider 또는 settings.json → language_models.openai_compatible / language_models.anthropic_compatible. 키는 설정 창(시스템 키체인에 보관) 또는 <대문자로 된 제공자 ID>_API_KEY 환경 변수에 지정합니다.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
openai_compatible의 주소에는 /v1을 포함합니다(/v1/chat/completions 사용; capabilities.chat_completions = false로 설정하면 모델이 /v1/responses를 사용합니다). anthropic_compatible의 주소에는 /v1을 넣지 않습니다(/v1/messages 사용; Zed는 x-api-key로 키를 보내고 Ailoot는 이를 받습니다). 기본값은 images = false 및 parallel_tool_calls = false입니다. Zed는 이미지를 보낼 수 있지만 현재 카탈로그 카드가 선택한 API 형식에서 image 입력을 지원한다고 명시한 모델에 한해서만 images를 켜세요. GPT와 Claude 예제에서는 images = false입니다. 2026-09-30 스냅샷은 해당 모델에 텍스트 입력만 명시합니다. 예를 들어 gemini-3.6-flash는 이 스냅샷에서 OpenAI Chat의 image 입력을 명시합니다. 실제 지원 여부는 모델 카드와 형식에 따라 달라집니다. 추론 모델용 필드 reasoning_effort가 있습니다. 예제의 max_tokens 값은 컨텍스트 크기입니다. 정확한 한도는 모델 카탈로그를 확인하세요.
채팅 모델 선택 → Manage Language Models(톱니바퀴) → Add Models → Custom Endpoint → VS Code가 chatLanguageModels.json 열기(이전 github.copilot.chat.customOAIModels 설정은 구식).
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
url은 endpoint의 전체 경로입니다. apiType 값: chat-completions, responses(url .../v1/responses), messages(url .../v1/messages). BYOK는 Copilot 요금제나 GitHub 로그인 없이도 채팅·에이전트에서 동작하지만 인라인 제안은 계속 Copilot을 사용합니다. 조직 관리자(Business/Enterprise)는 BYOK 정책을 끌 수 있습니다. 위 토큰 한도는 예제이므로 카탈로그 값을 사용하세요. vision = false는 2026-09-30 스냅샷이 GPT/OpenAI Chat 및 Claude/Anthropic Messages에 텍스트만 명시하기 때문입니다. VS Code가 vision을 제공해도 현재 카드가 해당 API 형식의 image 입력을 명시한 모델에서만 켜세요. 클라이언트 필드가 모델의 이미지 지원을 증명하지는 않습니다.
Settings | Tools | AI Assistant | Providers & API keys → Third-party AI providers → OpenAI-compatible → URL, API Key → Test Connection → Apply → AI Chat / Models Assignment
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Provider: OpenAI-compatible
URL: https://api.ailoot.ai/v1
API Key: sk-...
모델 예제: claude-sonnet-5-5
중요
OpenAI-compatible을 선택하고 URL에 https://api.ailoot.ai/v1, API Key에 자신의 키를 입력하세요. Test Connection과 Apply를 차례로 누른 뒤 AI Chat에서 모델을 선택하세요. IDE 기능에 사용하려면 Models Assignment에서 모델을 지정하세요. Tool calling은 선택한 모델이 도구를 지원할 때만 켜세요. 코드 완성은 별도로 설정합니다.
Xcode → Settings → Intelligence → Chat → Add a Chat Provider → Internet Hosted → URL, API Key, API Key Header, 설명 → Add.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Type: Internet Hosted
URL: https://api.ailoot.ai (/v1 제외 — Xcode가 /v1/models와 /v1/chat/completions를 자동으로 추가합니다)
API Key: sk-...
API Key Header: x-api-key
Description: Ailoot
→ 그런 다음 목록에서 모델 선택 (예: claude-sonnet-5-5, gpt-6.1-sol)
모델 예제: claude-sonnet-5-5
중요
Apple은 제공자가 Chat Completions를 지원하고 {URL}/v1/models 및 {URL}/v1/chat/completions에 응답하도록 요구합니다. Ailoot는 x-api-key 및 Authorization: Bearer를 허용합니다(Authorization을 선택하면 사용자 보고에 따르면 Xcode가 Bearer를 자동 추가). Xcode 에이전트는 별도 설정이며 이 안내에 포함하지 않습니다.
lazy.nvim에서 yetone/avante.nvim의 opts: opts.providers.<이름>에 __inherited_from = 'openai'를 지정(사용자 지정 OpenAI 호환 제공자)하거나 providers.claude.endpoint를 덮어씁니다. 키는 api_key_name에 지정된 변수에서 읽으며 AVANTE_* 이름을 지원합니다.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
플러그인 위키의 OpenAI 호환 주소는 /v1로 끝납니다. 플러그인이 /chat/completions를 추가합니다. 내장 claude 제공자는 https://api.anthropic.com 같은 주소를 쓰므로 Ailoot에서는 /v1을 제외합니다. __inherited_from 없는 사용자 지정 제공자는 전체 주소와 자체 응답 파싱 함수가 필요합니다.
require('codecompanion').setup({ adapters = { http = { ... } } })에서 adapters.extend('openai_compatible', ...) 또는 extend('anthropic', ...); 이후 interactions.chat/inline.adapter.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: gpt-6.1-sol
중요
openai_compatible은 호스트(env.url, /v1 제외)와 경로(env.chat_url)를 구분합니다. env 값은 환경 변수 이름, cmd:..., file:... 또는 Lua 함수일 수 있습니다. anthropic 어댑터도 /v1/messages용 사용자 지정 url로 확장할 수 있습니다.
init.el: gptel-make-openai(OpenAI Chat), gptel-make-anthropic(Messages) 또는 gptel-make-gemini로 백엔드를 등록합니다. 각 함수에 :host, :endpoint, :key, :stream, :models가 있으며 이후 gptel-backend와 gptel-model을 지정하세요.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
(setq gptel-model 'claude-sonnet-5-5
gptel-backend
(gptel-make-openai "Ailoot"
:host "api.ailoot.ai"
:endpoint "/v1/chat/completions"
:stream t
:key (getenv "AILOOT_API_KEY") ; 또는 (gptel-api-key-from-environment "AILOOT_API_KEY")
:models '(claude-sonnet-5-5 gpt-6.1-sol deepseek-v4-pro qwen3.8-max)))
;; Anthropic Messages를 사용하는 방식
(gptel-make-anthropic "Ailoot-Claude"
:host "api.ailoot.ai" ; 기본 경로 /v1/messages
:stream t
:key (getenv "AILOOT_API_KEY")
:models '(claude-sonnet-5-5 claude-opus-5-5))
키를 읽어 오는 환경 변수: AILOOT_API_KEY — 실행 전에 설정하세요:
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
Settings → Models → Add Model → Custom Model → API Format, Request URL(Full URL 스위치), Model ID, Display Name, API Key; 선택 사항 Advanced Settings.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OpenAI 형식:
API Format: OpenAI Chat Completions
Full URL: OFF
Request URL: https://api.ailoot.ai/v1
Model ID: gpt-6.1-sol
API Key: sk-...
Anthropic 형식:
API Format: Anthropic Messages
Full URL: OFF
Request URL: https://api.ailoot.ai
Model ID: claude-sonnet-5-5
API Key: sk-...
모델 예제: gpt-6.1-sol
중요
Full URL이 꺼져 있으면 Trae가 형식별 경로를 추가합니다(OpenAI 주소는 /v1 포함, Anthropic은 /v1 제외). 켜져 있으면 https://api.ailoot.ai/v1/chat/completions 또는 https://api.ailoot.ai/v1/messages 전체 주소를 입력하세요. Model Series는 모델군에 맞는 안내를 제공합니다.
Settings > Admin > Connections > Manage OpenAI API Connections > + Add Connection(또는 컨테이너 시작 시 OPENAI_API_BASE_URL / OPENAI_API_KEY 환경 변수)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
UI: URL = https://api.ailoot.ai/v1
API Key = sk-...
Model IDs: 비워 두면 /v1/models에서 불러옴; 또는 claude-sonnet-5-5, gpt-6.1-sol을 수동 추가
Docker env:
OPENAI_API_BASE_URL=https://api.ailoot.ai/v1
OPENAI_API_KEY=sk-...
모델 예제: claude-sonnet-5-5
중요
OpenAI Chat Completions 형식입니다. URL에는 /v1이 필수이며 마지막 슬래시는 제외합니다. /v1/models에서 목록을 가져오며 큰 카탈로그(모델 252개)는 Model IDs 제한과 목록 캐시(Cache Base Model List / ENABLE_BASE_MODELS_CACHE=True)를 켜면 편리합니다. RAG 임베딩은 별도의 RAG_OPENAI_API_BASE_URL을 사용합니다.
librechat.yaml → endpoints.custom(.env에서 ${VAR}로 키 참조); Anthropic 형식 — provider: 'anthropic' 필드
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Settings(톱니바퀴) > Model Provider > + Add Provider > OpenAI / OpenAI Responses / Anthropic / Gemini 프로토콜 타입
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Provider Name: Ailoot
유형: OpenAI (또는 OpenAI Responses / Anthropic)
API Key: sk-...
Base URL: https://api.ailoot.ai
→ 입력란 아래의 최종 주소 미리보기를 확인하세요. 다음 주소가 표시되어야 합니다: https://api.ailoot.ai/v1/chat/completions (Anthropic의 경우 — https://api.ailoot.ai/v1/messages)
Models: + claude-sonnet-5-5, gpt-6.1-sol
그런 다음 Model Check 버튼 클릭
모델 예제: claude-sonnet-5-5
중요
문서는 OpenAI, Anthropic, OpenAI Responses, Gemini와 필드 아래 최종 경로 미리보기를 확인하지만 /v1 추가 규칙은 설명하지 않습니다. 미리보기를 기준으로 설정하세요. Ailoot의 Chat Completions, Responses, Messages 세 형식이 모두 적합합니다.
설정(사이드바 버튼) > Model Provider > Add(하단) > OpenAI API Compatible 타입
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Name: Ailoot
API Mode: OpenAI API Compatible
API Key: sk-...
API Host: https://api.ailoot.ai
API Path: (비워 두세요. 기본값은 /v1/chat/completions)
Models: + gpt-6.1-sol, claude-sonnet-5-5 (이 예제에서는 vision 비활성화; tool_use는 선택한 모델의 지원 여부에 따라 설정)
모델 예제: gpt-6.1-sol
중요
문서의 API Host는 /v1을 제외하며(예: https://api.openai.com), 기본 경로는 /v1/chat/completions입니다. Google Gemini compatible 타입도 있지만 Ailoot의 /v1beta에서는 검증하지 않았습니다. JSON 설정 가져오기(type: 'openai', apiHost, apiPath)는 1.15.1부터 chatbox://provider/import?config=<base64>로 가능합니다. 예제 GPT·Claude의 vision은 꺼져 있습니다. 2026-09-30 카탈로그 스냅샷은 OpenAI Chat에서 텍스트만 명시합니다. Chatbox 버전이 vision을 제공해도 선택한 API 형식에서 현재 카드가 image 입력을 명시한 모델에만 활성화하세요. 클라이언트의 이미지 첨부 기능이 모델의 지원을 증명하지는 않습니다.
자체 호스팅: 환경 변수 OPENAI_PROXY_URL / OPENAI_API_KEY / OPENAI_MODEL_LIST, ANTHROPIC_PROXY_URL, GOOGLE_PROXY_URL
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OPENAI_API_KEY=sk-...
OPENAI_PROXY_URL=https://api.ailoot.ai/v1
OPENAI_MODEL_LIST=-all,+gpt-6.1-sol,+claude-sonnet-5-5,+deepseek-v4-pro
# Anthropic 형식 (선택 사항)
ANTHROPIC_API_KEY=sk-...
ANTHROPIC_PROXY_URL=https://api.ailoot.ai
모델 예제: claude-sonnet-5-5
중요
OPENAI_PROXY_URL 기본값은 https://api.openai.com/v1이므로 /v1을 포함합니다. ANTHROPIC_PROXY_URL 기본값은 https://api.anthropic.com(/v1 제외)입니다. GOOGLE_PROXY_URL로 이론상 Gemini 형식(https://api.ailoot.ai)을 연결할 수 있지만 이 방식은 검증하지 않았습니다. 서버 모드를 사용하세요. 브라우저에서 직접 요청하면 Ailoot API가 CORS로 거부할 수 있습니다.
Settings > Model Providers > Add Provider → OpenAI-compatible 또는 Anthropic-compatible 형식 선택
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OpenAI-compatible:
Provider name: Ailoot
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Anthropic-compatible:
Provider name: Ailoot Claude
Base URL: https://api.ailoot.ai
API key: sk-...
Models: {base_url}/models에서 불러오거나 + 수동 추가: claude-sonnet-5-5
모델 예제: claude-sonnet-5-5
중요
문서에 따르면 OpenAI 호환 Base URL에는 /v1이 필수이며 없으면 404가 발생합니다. 마지막 슬래시는 제거합니다. Anthropic 모드의 LiteLLM 예제는 /v1을 제외합니다. 사용자 제공자의 tools, vision은 직접 지정합니다. 예비 키를 지원하며 401/403/429에서만 재시도합니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
UI: Base URL = https://api.ailoot.ai/v1
API Key = sk-...
Chat Model Name = deepseek-v4-pro
Token context window = 모델에 맞게 설정
Docker .env:
LLM_PROVIDER='generic-openai'
GENERIC_OPEN_AI_BASE_PATH='https://api.ailoot.ai/v1'
GENERIC_OPEN_AI_MODEL_PREF='deepseek-v4-pro'
GENERIC_OPEN_AI_MODEL_TOKEN_LIMIT=128000
GENERIC_OPEN_AI_API_KEY='sk-...'
모델 예제: deepseek-v4-pro
중요
문서는 이 제공자를 «개발자용»으로 표시합니다. 필요한 경우 GENERIC_OPEN_AI_MODEL_MAX_TOKEN_KEY='max_completion_tokens'. 임베딩은 별도의 generic-openai embedder(EMBEDDING_BASE_PATH + GENERIC_OPEN_AI_EMBEDDING_API_KEY)를 사용하며 nemotron-3-embed 모델을 /v1/embeddings로 호출합니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Settings > Models > (+) > OpenAI-compatible Server
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Friendly name: Ailoot
API Endpoint URL: https://api.ailoot.ai/v1/chat/completions
API Key: sk-...
Model ID: gpt-6.1-sol
Context length: 모델에 맞게 설정
Streaming: 활성화
모델 예제: gpt-6.1-sol
중요
chat completions의 전체 주소가 필요합니다. AI Command에서 쓰려면 이 서비스를 기본 서비스로 설정하세요. BoltAI 도움말을 바탕으로 한 설명이며 BoltAI 2의 창은 다를 수 있습니다.
이 설정에서는 NextChat 서버를 통해 OpenAI Chat을 사용하세요. Vercel 또는 Docker에 배포할 때 BASE_URL=https://api.ailoot.ai(/v1 제외), OPENAI_API_KEY, CUSTOM_MODELS, DEFAULT_MODEL을 설정하세요. 이 변수를 변경한 뒤에는 서버를 다시 배포하세요.
Settings > Copilot > BYOK > Add a provider > Add a custom provider
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Model ID: claude-sonnet-5-5 (또는 /v1/models 목록에서 선택)
그런 다음 Test 클릭; Basic > Agents > Quick Chat에서 모델 활성화
모델 예제: claude-sonnet-5-5
중요
모델 목록은 /v1/models에서 가져오며 모델을 직접 입력할 수도 있습니다. Test가 통과해도 Quick Chat이 메시지를 보내지 않으면 제공자의 Enable CORS를 켜세요(스트리밍 없이 전체 응답). 키는 Obsidian Keychain에 저장됩니다.
base_url은 /chat/completions 접미사 없는 OpenAI 호환 endpoint입니다. Raycast는 재시작 없이 파일을 다시 읽습니다. abilities가 없으면 tools와 vision 미지원으로 간주합니다. 모델은 Quick AI, AI Chat, AI Commands에 나타납니다. 예제의 vision.supported = false는 2026-09-30 카탈로그가 Claude/OpenAI Chat에 텍스트만 명시하기 때문입니다. Raycast 버전이 설정을 지원해도 현재 카드가 OpenAI Chat의 image 입력을 명시한 모델에서만 켜세요. 클라이언트 플래그가 API의 이미지 지원을 증명하지는 않습니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Name: Claude Sonnet 5.5 (Ailoot)
API Type: OpenAI Chat Completions
Endpoint: https://api.ailoot.ai/v1/chat/completions
Model ID: claude-sonnet-5-5
Custom Headers: Authorization = Bearer sk-...
Context Length: 모델에 맞게 설정
Test → Save
모델 예제: claude-sonnet-5-5
중요
Endpoint는 전체 경로로 입력합니다. 키는 Authorization: Bearer sk-... 사용자 헤더로 보내며 Ailoot가 허용합니다. 웹 TypingMind는 브라우저에서 API를 직접 호출해 현재 CORS가 차단할 수 있으므로 데스크톱 버전이 더 안정적입니다. Gemini 타입은 Ailoot가 허용하지 않는 apiKey 헤더로 키를 보내므로 OpenAI Chat Completions 타입을 사용하세요.
생성자 OpenAI(base_url=..., api_key=...) 또는 환경 변수 OPENAI_BASE_URL 및 OPENAI_API_KEY
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..."
# 환경 변수
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
# 또는 코드에서
ailoot-openai-python-sdk.py
import os
from openai import OpenAI
client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
r = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role":"user","content":"안녕하세요"}])
print(r.choices[0].message.content)
# Responses API: client.responses.create(model="gpt-6.1-sol", input="안녕하세요")
# 임베딩: client.embeddings.create(model="nemotron-3-embed", input=["텍스트"])
python3 ailoot-openai-python-sdk.py
모델 예제: gpt-6.1-sol, claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-max (채팅); nemotron-3-embed (임베딩)
중요
주소에 /v1을 포함하세요. SDK가 /chat/completions, /responses, /embeddings, /images/*, /audio/*를 추가합니다. Chat Completions와 Responses(카탈로그에 형식이 있는 모델)는 동작합니다. 스트리밍과 도구는 표준 방식입니다. 오류는 Request ID가 포함된 JSON으로 반환되며 openai.APIStatusError로 처리합니다.
생성자 옵션 new OpenAI({ baseURL, apiKey }); SDK는 기본적으로 OPENAI_BASE_URL 환경 변수를 읽음
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: claude-sonnet-5-5, gpt-6.1-sol, grok-4.7
중요
README에는 baseURL이 표시됩니다. OPENAI_BASE_URL은 클라이언트 소스(src/client.ts)에서 읽으며 기본값은 https://api.openai.com/v1입니다. Ailoot 주소에는 /v1을 포함합니다. chat.completions와 responses를 모두 사용할 수 있습니다.
모델 예제: claude-sonnet-5-5, claude-opus-5-5; /v1/messages를 통해서도 gpt-6.1-sol, deepseek-v4-pro, gemini-3.6-flash
중요
/v1을 제외한 주소를 사용하세요. SDK가 /v1/messages를 자동 추가합니다. 게이트웨이는 x-api-key(SDK의 전송 방식) 및 Authorization: Bearer의 키를 허용합니다. 스트리밍, 도구, /v1/messages/count_tokens가 동작합니다. 배치(Batches) 및 Files API는 Ailoot 카탈로그에 명시되어 있지 않습니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
ChatOpenAI(base_url=...) 또는 OPENAI_API_BASE / OPENAI_BASE_URL 변수; ChatAnthropic(base_url=...) 또는 ANTHROPIC_API_URL / ANTHROPIC_BASE_URL
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="gpt-6.1-sol", base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
print(llm.invoke("안녕하세요").content)
from langchain_anthropic import ChatAnthropic
claude = ChatAnthropic(model="claude-sonnet-5-5", base_url="https://api.ailoot.ai", api_key=os.environ["AILOOT_API_KEY"])
모델 예제: gpt-6.1-sol, qwen3.8-max (ChatOpenAI); claude-sonnet-5-5 (ChatAnthropic)
중요
ChatOpenAI 주소는 /v1을 포함합니다. 문서는 OpenAI 공식 규격만 지원한다고 설명하며 외부 모델의 reasoning_content 같은 비표준 필드는 보존하지 않습니다. Claude는 ChatAnthropic을 권장합니다. /v1을 제외하면 SDK가 /v1/messages를 추가합니다. ChatAnthropic의 base_url 및 ANTHROPIC_API_URL/ANTHROPIC_BASE_URL은 통합 페이지가 아니라 소스의 클래스 문서(langchain_anthropic/chat_models.py)에 설명되어 있습니다. use_responses_api는 Responses 모드를 켭니다.
crewai.LLM(model=..., base_url=..., api_key=...); 환경 변수 OPENAI_API_KEY 및 OPENAI_BASE_URL; Claude — base_url이 있는 네이티브 anthropic/ 제공자
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/messages가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
import os
from crewai import LLM
# OpenAI 호환 형식
llm = LLM(model="openai/gpt-6.1-sol", base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
# Anthropic Messages
claude = LLM(model="anthropic/claude-sonnet-5-5", base_url="https://api.ailoot.ai", api_key=os.environ["AILOOT_API_KEY"], max_tokens=4096)
모델 예제: openai/gpt-6.1-sol, anthropic/claude-sonnet-5-5
중요
openai/ 또는 anthropic/ 접두사가 CrewAI 제공자를 선택하며 요청에는 접두사 없는 id를 전송합니다. OpenAI 주소는 /v1을 포함하고 Anthropic 주소는 /v1을 제외합니다. 문서는 임의의 OpenAI 호환 게이트웨이를 위한 custom_openai=True 플래그도 설명합니다. Anthropic에는 max_tokens가 필수입니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["AILOOT_API_KEY"],
http_options=types.HttpOptions(base_url="https://api.ailoot.ai"))
r = client.models.generate_content(model="gemini-3.6-flash", contents="안녕하세요")
print(r.text)
모델 예제: gemini-3.6-flash, gemini-3.1-pro
중요
주소에 /v1beta를 제외하세요. SDK가 /v1beta/models/{model}:generateContent를 자동 구성합니다. 키는 x-goog-api-key 헤더로 보내며 Ailoot가 허용합니다. Gemini 형식 모델만 사용할 수 있습니다. JavaScript 버전(@google/genai)은 문서에 사용자 지정 주소 설명이 없어 여기서 소개하지 않습니다.
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
id: "ailoot-agent",
name: "Ailoot Agent",
instructions: "러시아어로 답해 줘",
model: {
id: "ailoot/claude-sonnet-5-5",
url: "https://api.ailoot.ai/v1",
apiKey: process.env.AILOOT_API_KEY
// api: "responses" // responses 메서드를 지원하는 모델에만 사용
}
});
키를 읽어 오는 환경 변수: AILOOT_API_KEY — 실행 전에 설정하세요:
export AILOOT_API_KEY="sk-..." # ~/.zshrc 또는 ~/.bashrc에 추가하세요
setx AILOOT_API_KEY "sk-..." # 그런 다음 터미널을 다시 시작하세요
모델 예제: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol
중요
url은 /v1을 포함한 기본 주소이며 /chat/completions 전체 경로가 아닙니다. 기본값은 Chat Completions이며 api: "responses"로 Responses API를 선택합니다. id 형식 "제공자/모델"은 모델 id만 게이트웨이에 전송합니다. 문서의 model 객체 apiKey는 헤더 예제에서만 표시되고 url과 함께 사용하는 방식은 별도로 설명하지 않습니다.
AsyncOpenAI(base_url=..., api_key=...) + OpenAIChatCompletionsModel(model=..., openai_client=client) 또는 전역 set_default_openai_client(client)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
import os
from agents import Agent, Runner, AsyncOpenAI, OpenAIChatCompletionsModel, set_tracing_disabled
set_tracing_disabled(disabled=True)
client = AsyncOpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
model = OpenAIChatCompletionsModel(model="claude-sonnet-5-5", openai_client=client)
agent = Agent(name="도우미", instructions="러시아어로 답해 줘", model=model)
print(Runner.run_sync(agent, "안녕하세요").final_output)
모델 예제: claude-sonnet-5-5, gpt-6.1-sol
중요
주소에는 /v1이 포함되어야 합니다. set_tracing_disabled(True)로 추적을 끄세요. 그렇지 않으면 OpenAI 키가 없는 상태에서 SDK가 추적 데이터를 OpenAI에 보내려고 합니다. Chat Completions는 카탈로그에 해당 메서드가 명시되어 있고 해당 키로 사용할 수 있는 모델에만 제공됩니다. Responses(SDK의 기본값)는 카탈로그에 responses 메서드가 명시된 모델에만 제공됩니다. OpenAI의 내장 도구(웹 검색, 파일)는 타사 게이트웨이를 통한 동작이 보장되지 않습니다.
OpenAIProvider(base_url=..., api_key=...) 및 OpenAIChatModel(Chat Completions) 또는 OpenAIResponsesModel(Responses); 다른 방법 — OPENAI_BASE_URL 변수
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider
model = OpenAIChatModel("deepseek-v4-pro",
provider=OpenAIProvider(base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"]))
agent = Agent(model)
print(agent.run_sync("안녕하세요").output)
모델 예제: deepseek-v4-pro, gpt-6.1-sol (OpenAIResponsesModel용)
중요
주소에 /v1을 포함합니다. 문서는 OpenAIResponsesModel을 기본으로 사용합니다. responses 메서드가 있는 모델에서만 선택하고 나머지는 OpenAIChatModel을 사용하세요.
Credentials → OpenAI → Base URL(기본값 https://api.openai.com/v1); Credentials → Anthropic → Base URL(기본값 https://api.anthropic.com); Credentials → Google Gemini(PaLM) Api → Host(기본값 https://generativelanguage.googleapis.com). 이후 OpenAI Chat Model / Anthropic Chat Model / Google Gemini Chat Model 노드
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OpenAI credential:
API Key: sk-...
Base URL: https://api.ailoot.ai/v1
Anthropic credential:
API Key: sk-...
Base URL: https://api.ailoot.ai
Google Gemini(PaLM) Api credential:
Host: https://api.ailoot.ai
API Key: sk-...
OpenAI Chat Model 노드 → Model: By ID → gpt-6.1-sol (Use Responses API 스위치는 responses 메서드를 지원하는 모델에만 사용)
모델 예제: gpt-6.1-sol / deepseek-v4-pro (OpenAI), claude-sonnet-5-5 (Anthropic), gemini-3.6-flash (Gemini)
중요
자격 증명 검증은 /models(OpenAI), /v1/models(Anthropic), /v1beta/models(Gemini)를 호출하며 Ailoot는 모두 제공합니다. n8n 문서 페이지에는 Base URL 설명이 없지만 실제 자격 증명에 있습니다(소스 OpenAiApi.credentials.ts 및 AnthropicApi.credentials.ts, «Override the default base URL for the API» 라벨). n8n Cloud에서는 «Use Gateway credits»를 선택하지 마세요. 이 옵션을 선택하면 요청이 Ailoot를 통하지 않습니다.
Integrations → Model Provider → OpenAI-API-compatible 플러그인 설치 → Add Model(Model Type, Model Name, API Key, API Base URL, Completion mode, Model context size 필드)
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Model Type: LLM
Model Name: claude-sonnet-5-5
API Key: sk-...
API Base URL: https://api.ailoot.ai/v1
Completion mode: Chat
Model context size: Ailoot 카탈로그의 모델 카드에 맞게 설정
Text Embedding의 경우:
Model Name: nemotron-3-embed
API Base URL: https://api.ailoot.ai
모델 예제: claude-sonnet-5-5, gpt-6.1-sol, qwen3.8-max; nemotron-3-embed (임베딩)
중요
제공자 관리는 워크스페이스 소유자와 관리자만 가능합니다. 플러그인 README에 따르면 LLM 주소에는 /v1을 포함하지만 임베딩, rerank, STT, TTS는 API 버전을 자동 추가하므로 /v1을 제외해야 합니다(그렇지 않으면 /v1/v1). Ailoot 모델을 각각 별도 항목으로 추가하고 이미지 입력 및 스트리밍은 모델 설정에서 활성화하세요.
프로필 → Settings → Model Providers → OpenAI Compatible(Base URL, API Key 필드; OPENAI_COMPATIBLE_BASE_URL 및 OPENAI_COMPATIBLE_API_KEY 변수). 다른 방법: OpenAI 컴포넌트 → OpenAI API Base 필드
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Settings → Model Providers → OpenAI Compatible:
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
또는 환경 변수를 사용:
export OPENAI_COMPATIBLE_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_COMPATIBLE_API_KEY="sk-..."
그런 다음 Language Model / Agent 구성 요소에서 OpenAI Compatible → claude-sonnet-5-5 선택
모델 예제: claude-sonnet-5-5, gpt-6.1-sol, nemotron-3-embed (Embedding Model)
중요
Langflow는 연결을 검증하고 /v1/models에서 목록을 가져옵니다. Language Models와 Embedding Models에 나타나며 필요한 모델은 이후 직접 활성화해야 합니다. 제공자는 langflow와 함께 설치됩니다.
Telegram 프레임워크에는 LLM 계층이 없으므로 메시지 처리기에서 Ailoot의 base_url을 쓰는 OpenAI SDK 또는 /v1 없는 base_url의 Anthropic SDK 호출
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
Python 코드를 ailoot-telegram-bot.py로 저장하세요. 의존성을 설치하고 두 환경 변수를 설정한 다음 파일을 실행하세요. 봇에 Hello를 보내 텍스트 응답을 확인하세요. 오류가 발생하면 Request ID를 보관하고 새 생성을 보내기 전에 원래 결과를 확인하세요.
python3 -m pip install "aiogram>=3,<4" openai
ailoot-telegram-bot.py
import asyncio
import os
from aiogram import Bot, Dispatcher, F
from aiogram.types import Message
from openai import AsyncOpenAI, APIError
async def main():
dp = Dispatcher()
async with AsyncOpenAI(
base_url="https://api.ailoot.ai/v1",
api_key=os.environ["AILOOT_API_KEY"],
max_retries=0,
) as llm:
@dp.message(F.text)
async def reply(message: Message):
try:
result = await llm.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": message.text}],
)
content = result.choices[0].message.content or "—"
for start in range(0, len(content), 4000):
await message.answer(content[start:start + 4000])
except APIError as error:
await message.answer(
f"{type(error).__name__}; Request ID: "
f"{getattr(error, 'request_id', None) or '—'}"
)
bot = Bot(token=os.environ["TELEGRAM_BOT_TOKEN"])
await dp.start_polling(bot)
if __name__ == "__main__":
asyncio.run(main())
~/.gemini/antigravity-cli/settings.json → "modelProvider": "gemini"; 변수 GEMINI_API_KEY 및 GOOGLE_GEMINI_BASE_URL
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1beta/models/{model}:generateContent가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
프로토콜은 네이티브 Gemini REST(streamGenerateContent, X-Goog-Api-Key로 키 전송)이며 경로는 https://api.ailoot.ai/v1beta/... 입니다. agy는 질문당 대화 제목과 실제 응답의 두 요청을 보냅니다. 각 단계에서 일반 채팅보다 많은 금액을 예약하므로 잔액에 여유를 두세요. 카드는 «검토 중»입니다. 문서를 바탕으로 만든 설정이며 아직 Ailoot를 통한 실제 클라이언트 실행은 하지 않았습니다. modelProvider = gemini이고 GEMINI_API_KEY가 비어 있으면 CLI가 시작되지 않습니다.
cline auth → 사용자 지정 API 제공자 → OpenAI Compatible: Base URL, API Key, Model ID; -P/--provider 플래그로 제공자 선택
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
cline auth
# API Provider: OpenAI Compatible
# Base URL: https://api.ailoot.ai/v1
# API Key: sk-...
# Model ID: claude-sonnet-5-5
cline "테스트를 실행하고 오류를 수정해 줘"
모델 예제: claude-sonnet-5-5
중요
Base URL / API Key / Model ID 필드는 Cline의 OpenAI Compatible 문서에 설명되어 있습니다. CLI 문서는 cline auth 마법사의 정확한 항목 이름을 표시하지 않으므로 화면과 비교하세요.
GitHub는 사용자 지정 엔드포인트 지원을 명시합니다. 공식 화면에는 Provider Name, API Key, API Type: Chat Completions가 있지만 URL 예시는 없습니다. 따라서 여기에는 복사해서 사용할 Ailoot 설정을 제공하지 않습니다. 이 IDE에서 설정 절차가 문서화된 대안은 JetBrains AI Assistant입니다. URL 요건은 플러그인의 공식 지원팀에 문의하세요.
Cursor Settings → Models → API Keys → OpenAI API Key + «Override OpenAI Base URL» 스위치; 이후 사용자 모델 목록에 모델 ID 추가.
설정
실행 전에 Ailoot 키로 GET /v1/models를 조회하세요. 지원 메서드에 POST /v1/chat/completions가 포함된 정확한 모델 ID를 선택해 설정에 사용하세요. 에이전트에서는 클라이언트 버전에 필요한 도구와 기능의 지원도 확인하세요.
OpenAI API Key: sk-...
Override OpenAI Base URL: https://api.ailoot.ai/v1
사용자 지정 모델: gpt-6.1-sol (추가하고 활성화한 뒤 채팅에서 선택)
모델 예제: gpt-6.1-sol
중요
현재 Cursor 공식 문서는 사용자 지정 주소를 설명하지 않습니다. OpenAI/Anthropic/Google/Azure/Bedrock 키만 표시하고 키는 채팅에서만 적용되며 Tab은 Cursor 모델을 사용한다고 설명합니다. 모든 요청은 Cursor 서버를 통과하므로 공개 주소가 필요합니다(api.ailoot.ai는 공개 주소). 주소 스위치는 UI에 있지만 포럼에서는 모든 모델에 적용되는 문제, Agent 모드가 사용자 키를 쓰지 않을 수 있는 문제, 일부 3.15.x 버전에서 필드 입력 불가를 보고합니다.
Visual Studio 블로그(29.09.2026)는 VS 2026 Stable의 OpenAI·Ollama 사용자 주소를 발표했습니다. 문서는 아직 주소 필드 없이 OpenAI/Anthropic/Google 키만 설명하므로 필드 이름과 주소 형식은 확인되지 않았습니다. 채팅만 지원하며 Copilot Business/Enterprise에서는 사용할 수 없습니다.
클라이언트가 지원하는 OpenAI, Anthropic 또는 Gemini 형식을 선택하세요. Ailoot 모델 카드에서 호환되는 API 메서드와 모델 ID를 확인하세요. 한 가지 형식을 지원한다고 해서 모든 모델이 모든 형식을 지원하는 것은 아닙니다.
클라이언트에서 무엇을 설정해야 하나요?
Ailoot API 키, API 주소, 클라이언트 메서드와 호환되는 모델 ID를 설정하세요. OpenAI SDK는 https://api.ailoot.ai/v1 을, Anthropic 및 Gemini SDK는 https://api.ailoot.ai 를 사용합니다. 해당 형식의 예제에 있는 요청 필드를 유지하세요.
첫 API 요청은 어떻게 보내나요?
Ailoot API 키를 만드세요. OpenAI SDK에는 https://api.ailoot.ai/v1 을, Anthropic 및 Gemini SDK에는 https://api.ailoot.ai 를 설정하세요. GET /v1/models 는 무료이며 키로 이용할 수 있는 모델 목록을 제공합니다. 그런 다음 선택한 모델과 API 메서드의 예제를 사용하세요.
연결된 클라이언트가 작동하지 않으면 무엇을 확인해야 하나요?
클라이언트가 Ailoot API 키를 사용해 예상되는 OpenAI, Anthropic 또는 Gemini 형식으로 해당 API 주소에 요청을 보내는지 확인하세요. 모델 ID와 메서드를 확인한 다음, 반환된 오류를 클라이언트 가이드와 대조하세요. 키는 공유하지 말고 오류와 요청 ID를 support@ailoot.ai 로 보내세요.
유료 제품에서 사용할 수 있나요?
네. 공식 이용 조건과 계약으로 SaaS, 앱, 봇에 연결하세요. 재판매는 프로젝트별 서면 조건과 라이선스를 요청하세요.
리셀러 라이선스는 어떻게 신청하나요?
제품의 기능, 사용자, 액세스를 제공하는 방법을 적어 support@ailoot.ai 로 이메일을 보내세요. 프로젝트에 대한 리셀러 라이선스와 서면 조건을 요청하세요.