프로바이더 카탈로그

50개 이상의 프로바이더에 대한 전체 카탈로그 — ID, 별칭, 기본 URL, 인증, 기능 및 temperature 호환성 포함.

Revka는 단일 통합 Provider 트레이트를 통해 50개 이상의 AI 프로바이더 백엔드와 통신합니다. 이 페이지는 레퍼런스 카탈로그로, 모든 정식 프로바이더 ID, 별칭, 기본 URL, 필요한 인증 정보, 지원하는 기능을 확인할 수 있습니다. config.toml에 설정할 default_provider 값, API 키를 위한 올바른 환경 변수, 그리고 특정 프로바이더가 비전 또는 네이티브 도구 호출을 지원하는지 확인하는 데 활용하시기 바랍니다.

단일 프로바이더를 빠르게 설정하려면 프로바이더 퀵스타트를 먼저 참고하세요. 클라우드 API, 로컬 서버, OAuth/구독, 중국 리전 엔드포인트 등 심층적인 프로바이더 패밀리 가이드는 아래 각 섹션의 교차 링크를 따라가세요.

revka providers   # print the live provider list from your build

프로바이더 구성 방식

프로바이더는 네 가지 구현 범주로 구분됩니다.

자체 구현을 갖는 퍼스트파티 API 프로바이더: anthropic, openai, gemini, bedrock, ollama, openrouter, azure_openai, openai-codex, telnyx, copilot, glm.
하나의 구현(OpenAiCompatibleProvider)을 공유하는 OpenAI 호환 프로바이더 — 가장 큰 패밀리로, Groq, Mistral, DeepSeek, xAI, Together, Fireworks 등 수십 개가 포함됩니다.
API를 직접 호출하는 대신 인증된 로컬 바이너리를 실행하는 CLI 서브프로세스 프로바이더: claude-code, gemini-cli, kilocli. OAuth & 구독 프로바이더를 참고하세요.
힌트 기반 디스패치, 폴백, 재시도를 임의의 기본 프로바이더 위에 추가하는 라우팅/신뢰성 래퍼 (RouterProvider, ReliableProvider). 라우팅, 신뢰성 & 튜닝을 참고하세요.

자격 증명 확인 순서

모든 프로바이더는 동일한 세 단계 우선순위 체인으로 자격 증명을 확인합니다.

설정 또는 CLI에서 명시적으로 지정한 자격 증명 (api_key).
아래 카탈로그에 나열된 프로바이더별 환경 변수 (예: OPENROUTER_API_KEY).
일반 폴백: REVKA_API_KEY, 이후 API_KEY.

신뢰성 체인(reliability.fallback_providers)의 경우, 각 폴백 프로바이더는 자격 증명을 독립적으로 확인합니다. 기본 프로바이더의 명시적 키는 폴백에 재사용되지 않습니다.

프로바이더 카탈로그

기능 열은 해당 프로바이더 구현이 지원하는 내용을 반영합니다. Vision(이미지 입력), Tools(네이티브 도구 호출), Local(자체 머신에서 실행). 빈 셀은 해당 기능이 해당 프로바이더에서 지원되지 않음을 의미합니다.

클라우드 API 프로바이더

정식 ID	별칭	기본 URL	인증 환경 변수	Tools	Vision
`openrouter`	—	provider-managed	`OPENROUTER_API_KEY`	✅	✅
`anthropic`	—	Anthropic Messages API	`ANTHROPIC_OAUTH_TOKEN`, `ANTHROPIC_API_KEY`	✅	✅
`openai`	—	`https://api.openai.com`	`OPENAI_API_KEY`	✅
`gemini`	`google`, `google-gemini`	`generativelanguage.googleapis.com/v1beta`	`GEMINI_API_KEY`, `GOOGLE_API_KEY`	✅	✅
`bedrock`	`aws-bedrock`	AWS Converse API	`AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY` (또는 `BEDROCK_API_KEY`)	✅
`azure_openai`	`azure-openai`, `azure`	resource/deployment URI	`AZURE_OPENAI_API_KEY`	✅
`groq`	—	`https://api.groq.com/openai/v1`	`GROQ_API_KEY`	✅
`mistral`	—	`https://api.mistral.ai/v1`	`MISTRAL_API_KEY`	✅
`xai`	`grok`	`https://api.x.ai`	`XAI_API_KEY`	✅
`deepseek`	—	`https://api.deepseek.com`	`DEEPSEEK_API_KEY`	✅
`together`	`together-ai`	`https://api.together.xyz`	`TOGETHER_API_KEY`	✅
`fireworks`	`fireworks-ai`	`https://api.fireworks.ai/inference/v1`	`FIREWORKS_API_KEY`	✅
`novita`	—	`https://api.novita.ai/openai`	`NOVITA_API_KEY`	✅
`perplexity`	—	`https://api.perplexity.ai`	`PERPLEXITY_API_KEY`	✅
`cohere`	—	`https://api.cohere.com/compatibility`	`COHERE_API_KEY`	✅
`venice`	—	`https://api.venice.ai`	`VENICE_API_KEY`
`vercel`	`vercel-ai`	`https://ai-gateway.vercel.sh/v1`	`VERCEL_API_KEY`	✅
`cloudflare`	`cloudflare-ai`	`https://gateway.ai.cloudflare.com/v1`	`CLOUDFLARE_API_KEY`	✅
`nvidia`	`nvidia-nim`, `build.nvidia.com`	`https://integrate.api.nvidia.com/v1`	`NVIDIA_API_KEY`	✅
`synthetic`	—	`https://api.synthetic.new/openai/v1`	`SYNTHETIC_API_KEY`	✅
`opencode`	`opencode-zen`	`https://opencode.ai/zen/v1`	`OPENCODE_API_KEY`	✅
`opencode-go`	—	`https://opencode.ai/zen/go/v1`	`OPENCODE_GO_API_KEY`	✅
`telnyx`	—	`https://api.telnyx.com/v2/ai`	`TELNYX_API_KEY`	✅
`aihubmix`	—	custom	`AIHUBMIX_API_KEY`	✅
`siliconflow`	`silicon-flow`	custom	`SILICONFLOW_API_KEY`	✅
`astrai`	—	custom	`ASTRAI_API_KEY`	✅
`avian`	—	custom	`AVIAN_API_KEY`	✅
`deepmyst`	`deep-myst`	custom	`DEEPMYST_API_KEY`	✅
`ovhcloud`	`ovh`	custom	`OVH_AI_ENDPOINTS_ACCESS_TOKEN`	✅

Gemini, Bedrock, Azure OpenAI 설정 — Vertex AI, AWS SigV4 대 Bearer 인증, Azure 리소스/배포 설정 포함 — 에 대한 자세한 내용은 클라우드 API 프로바이더를 참고하세요.

중국 리전 프로바이더

이 프로바이더들은 선택한 별칭(또는 MINIMAX_OAUTH_REGION)에 따라 글로벌 또는 CN 기본 URL로 라우팅됩니다. 전체 별칭 및 리전 라우팅 표는 중국 리전 프로바이더를 참고하세요.

정식 ID	주요 별칭	기본 URL (글로벌 / CN)	인증 환경 변수
`zai`	`z.ai`, `zai-global`, `zai-cn`	`https://api.z.ai/api/coding/paas/v4` / `https://open.bigmodel.cn/api/coding/paas/v4`	`ZAI_API_KEY`
`glm`	`zhipu`, `glm-global`, `glm-cn`, `bigmodel`	`https://api.z.ai/api/paas/v4` / `https://open.bigmodel.cn/api/paas/v4`	`GLM_API_KEY`
`minimax`	`minimax-intl`, `minimax-cn`, `minimaxi`, `minimax-oauth`	`https://api.minimax.io/v1` / `https://api.minimaxi.com/v1`	`MINIMAX_OAUTH_TOKEN`, `MINIMAX_API_KEY`
`moonshot`	`kimi`, `moonshot-intl`, `moonshot-cn`, `kimi-cn`	`https://api.moonshot.ai/v1` / `.cn`	`MOONSHOT_API_KEY`
`kimi-code`	`kimi_coding`, `kimi_for_coding`	`https://api.kimi.com/coding/v1`	`KIMI_CODE_API_KEY`, `MOONSHOT_API_KEY`
`qwen`	`dashscope`, `qwen-intl`, `qwen-us`, `qwen-code`, `qwen-oauth`	region-specific DashScope	`DASHSCOPE_API_KEY`, `QWEN_OAUTH_TOKEN`
`bailian`	`aliyun-bailian`, `aliyun`	`https://coding.dashscope.aliyuncs.com/v1`	`BAILIAN_API_KEY`, `DASHSCOPE_API_KEY`
`qianfan`	`baidu`	`https://qianfan.baidubce.com/v2`	`QIANFAN_API_KEY`
`doubao`	`volcengine`, `ark`, `doubao-cn`	`https://ark.cn-beijing.volces.com/api/v3`	`ARK_API_KEY`, `DOUBAO_API_KEY`

로컬 및 셀프호스팅 프로바이더

로컬 서버는 기본적으로 localhost 엔드포인트를 사용하며, 인증은 선택 사항입니다. 더미 키가 필요하지 않습니다. api_url로 호스트/포트를 재정의할 수 있습니다. 로컬, 셀프호스팅 & 커스텀 엔드포인트를 참고하세요.

정식 ID	별칭	기본 엔드포인트	API 키
`ollama`	—	`http://localhost:11434` (네이티브 `/api/chat`)	`OLLAMA_API_KEY` (선택 사항)
`llamacpp`	`llama.cpp`	`http://localhost:8080/v1`	`LLAMACPP_API_KEY` (선택 사항; 비전 지원)
`lmstudio`	`lm-studio`	`http://localhost:1234/v1`	선택 사항 (기본값: `lm-studio`)
`vllm`	—	`http://localhost:8000/v1`	`VLLM_API_KEY` (선택 사항)
`sglang`	—	`http://localhost:30000/v1`	`SGLANG_API_KEY` (선택 사항)
`osaurus`	—	`http://localhost:1337/v1`	`OSAURUS_API_KEY` (선택 사항; 기본값: `osaurus`)

OAuth & 구독 프로바이더

이 프로바이더들은 직접 API 키 대신 네이티브 CLI 또는 OAuth 플로우를 통해 인증된 구독을 재사용합니다. OAuth & 구독 프로바이더를 참고하세요.

정식 ID	별칭	인증 방식
`claude-code`	—	로컬 Claude Code CLI 세션 (바이너리 경로: `CLAUDE_CODE_PATH`)
`gemini-cli`	—	Gemini CLI OAuth (`~/.gemini/oauth_creds.json`); `GEMINI_API_KEY` 폴백
`kilocli`	`kilo`	로컬 KiloCLI 세션 (바이너리 경로: `KILO_CLI_PATH`)
`openai-codex`	`codex`	`revka auth login --provider openai-codex`를 통한 OAuth (`~/.revka/auth/`에 캐시됨)
`copilot`	`github-copilot`	GitHub 디바이스 코드 플로우; 설정의 GitHub OAuth 토큰 또는 `API_KEY` 폴백

OpenAI 호환 프로바이더 (일반)

단일 구현체인 OpenAiCompatibleProvider는 OpenAI /v1/chat/completions(또는 /v1/responses) JSON 형식을 사용하는 모든 프로바이더를 지원합니다. Bearer 또는 X-Api-Key 인증, 커스텀 User-Agent, base64 이미지를 통한 비전, 404 시 선택적 responses-API 폴백, OpenAI JSON 스키마를 사용한 네이티브 도구 호출, reasoning-effort 전달, 추가 HTTP 헤더, 설정 가능한 타임아웃, 커스텀 API 경로, 최대 토큰 제한을 처리합니다.

대부분의 경우 명명된 OpenAI 호환 프로바이더(Groq, Mistral 등)를 ID로 선택합니다. 등록되지 않은 엔드포인트가 필요한 경우 custom: 접두사를 사용하세요.

default_provider = "custom:https://your-api.example.com/v1"
api_key          = "your-key"
default_model    = "your-model-name"

일부 명명된 프로바이더에는 알아두어야 할 구현상의 특이사항이 있습니다.

MiniMax는 merge_system_into_user를 설정합니다 — MiniMax API가 독립적인 system 역할을 거부하기 때문에 role: system 메시지가 첫 번째 사용자 턴에 병합됩니다. 이는 전달 안내가 담긴 시스템 프롬프트를 포함하는 채널 대화에 영향을 줍니다.
GLM과 NVIDIA는 responses-API 폴백(no_responses_fallback)을 비활성화하므로, 404가 발생하면 /v1/responses로 재시도하지 않고 해당 오류를 그대로 반환합니다.
Venice는 without_native_tools를 사용합니다 — 도구 호출이 네이티브 도구 API 대신 프롬프트 인젝션으로 에뮬레이션됩니다.

custom:, api_url, api_path, extra_headers에 대한 자세한 내용은 로컬, 셀프호스팅 & 커스텀 엔드포인트를 참고하세요.

OpenRouter

OpenRouter는 기본 제공 기본 프로바이더로, 하나의 키로 200개 이상의 모델에 액세스할 수 있습니다. 모델 ID는 provider/model-name 형식을 사용합니다.

default_provider = "openrouter"
default_model    = "anthropic/claude-sonnet-4-6"

항목	값
인증 환경 변수	`OPENROUTER_API_KEY` (키는 `sk-or-`로 시작)
`provider_timeout_secs`	`120` (기본값)
`provider_max_tokens`	선택적 출력 토큰 제한

Anthropic

Anthropic Messages API와의 직접 통합입니다. 네이티브 도구 호출, 비전(base64 인라인 이미지), 프롬프트 캐싱(cache_control), SSE 스트리밍, reasoning-content 전달을 지원합니다.

default_provider = "anthropic"
default_model    = "claude-sonnet-4-6-20250514"

CLI에서 단일 호출:

revka agent -p anthropic --model claude-opus-4-6 -m "Hello"

항목	값
`ANTHROPIC_API_KEY`	표준 Anthropic API 키 (`sk-ant-…`)
`ANTHROPIC_OAUTH_TOKEN`	설정/OAuth 토큰 — `ANTHROPIC_API_KEY`보다 먼저 확인되며, 일반 API 사용이 아닌 인증 설정 플로우 전용입니다
기본 `max_tokens`	`4096` (`provider_max_tokens`로 재정의 가능)

OpenAI

OpenAI Chat Completions API(/v1/chat/completions)와의 직접 통합입니다. 네이티브 도구 호출 및 reasoning-content 처리를 지원합니다 — o/o3 패밀리는 content 대신 reasoning_content를 반환하며, content가 비어 있으면 프로바이더가 투명하게 reasoning_content로 폴백하여 호출자는 항상 텍스트를 수신합니다.

default_provider = "openai"
default_model    = "gpt-4o"
api_url          = "https://api.openai.com"   # optional custom base

항목	값
`OPENAI_API_KEY`	API 키 (`sk-…`)
`api_url` / `--api-url`	기본 기본 URL 재정의
`provider_max_tokens`	출력 토큰 제한

어떤 모델 패밀리가 어떤 temperature 값을 허용하는지는 아래 OpenAI temperature 호환성을 참고하세요.

Telnyx

/v2/ai/chat/completions OpenAI 호환 엔드포인트를 통한 Telnyx AI 추론으로, 단일 Telnyx 키로 GPT-4o, Claude, Llama, Mistral 등 50개 이상의 모델에 액세스할 수 있습니다.

default_provider = "telnyx"
default_model    = "openai/gpt-4o"

항목	값
인증 환경 변수	`TELNYX_API_KEY` (키는 `KEY-`로 시작)
기본 URL	`https://api.telnyx.com/v2/ai`
HTTP 타임아웃	120초

모델 ID는 provider/model 형식을 사용합니다. 예: openai/gpt-4o 또는 anthropic.claude-sonnet-4-6.

API 키 불일치 감지

프로바이더를 구성하기 전에, Revka는 확인된 키의 접두사를 선택한 프로바이더와 대조하여 명백히 일치하지 않는 경우 읽기 쉬운 오류를 발생시킵니다 — 예를 들어 sk-ant- 키를 openai 프로바이더와 함께 사용하는 경우입니다. 이는 흔한 복사-붙여넣기 실수를 방지하기 위한 안전장치입니다.

키 접두사	예상 프로바이더
`sk-ant-`	`anthropic`
`sk-or-`	`openrouter`
`sk-`	`openai`
`gsk_`	`groq`
`pplx-`	`perplexity`
`xai-`	`xai`
`nvapi-`	`nvidia`
`KEY-`	`telnyx`

오류 메시지의 시크릿 스크러빙

프로바이더 API 호출이 실패하면, 오류 본문에 요청의 일부 — 키 포함 — 가 반영될 수 있습니다. Revka는 모든 프로바이더 오류에서 토큰과 유사한 패턴을 스크러빙한 후 로그 파일이나 채팅 응답에 도달하게 하며, 메시지를 500자로 자릅니다.

스크러빙 대상 패턴에는 sk-, xoxb-, xoxp-, ghp_, gho_, ghu_, github_pat_로 시작하는 키가 포함됩니다. 업스트림 오류 본문에 키가 포함되더라도 [REDACTED]로 표시됩니다. 이는 모든 프로바이더에 자동으로 적용되며 별도 설정이 필요하지 않습니다.

OpenAI temperature 호환성

OpenAI 모델 패밀리는 temperature 요건이 서로 다릅니다. openai 프로바이더는 adjust_temperature_for_model()을 통해 값을 자동으로 조정하지만, temperature 오류가 발생하거나 모델을 선택할 때 아래 표가 유용합니다.

추론 모델 (o 시리즈, gpt-5 기본 변형): temperature=1.0만 허용합니다.
표준 모델 (gpt-3.5, gpt-4, gpt-4o, gpt-4.1, chat-latest 변형): 0.0–2.0 전체 범위를 허용합니다.

패밀리 / 모델	Temperature 동작
`o1`, `o3`, `o3-mini`, `o4-mini` (및 날짜 포함 변형)	`temperature=1.0` 필수
`gpt-5`, `gpt-5-mini`, `gpt-5-nano` (및 날짜 포함 변형)	`temperature=1.0` 필수
`gpt-5.1-chat-latest`, `gpt-5.2-chat-latest`, `gpt-5.3-chat-latest`	`temperature=1.0` 필수
`gpt-3.5-turbo`, `gpt-4`, `gpt-4-turbo`, `gpt-4o`, `gpt-4o-mini`, `gpt-4.1` (모든 변형)	`0.0–2.0` 허용
`gpt-5-chat-latest`, `gpt-5.2`, `gpt-5.4` (및 날짜 포함 변형)	`0.0–2.0` 허용

프로바이더 검증

revka doctor models --provider <id>   # probe one provider: ok / auth-error / error
revka models refresh --provider <id>  # pull the live model catalog
revka doctor                          # validate the resolved provider, key, and model

revka doctor models는 프로바이더에 연결 가능하고 키가 유효한 경우 모델 수와 함께 ok를, 자격 증명이 잘못된 경우 auth-error를, 엔드포인트에 접근할 수 없는 경우 연결 오류를 보고합니다. 일부 프로바이더(예: copilot)는 라이브 모델 검색을 지원하지 않아 skipped로 표시됩니다.

다음 단계

프로바이더 퀵스타트 프로바이더를 선택하고, 키를 설정하고, 첫 번째 채팅을 실행하세요.

클라우드 API 프로바이더 Gemini(Vertex AI 포함), AWS Bedrock, Azure OpenAI 설정.

로컬, 셀프호스팅 & 커스텀 엔드포인트 Ollama, llama.cpp, vLLM, SGLang 및 custom: 접두사.

OAuth & 구독 프로바이더 claude-code, openai-codex, gemini-cli, Copilot, MiniMax & Qwen OAuth.

중국 리전 프로바이더 GLM, MiniMax, Qwen/DashScope, Moonshot/Kimi 리전 라우팅.

라우팅, 신뢰성 & 튜닝 모델 라우트, 폴백 체인, 타임아웃, 키 불일치 감지.

프로바이더 카탈로그

프로바이더 구성 방식

자격 증명 확인 순서

프로바이더 카탈로그

클라우드 API 프로바이더

중국 리전 프로바이더

로컬 및 셀프호스팅 프로바이더

OAuth & 구독 프로바이더

OpenAI 호환 프로바이더 (일반)

OpenRouter

Anthropic

OpenAI

Telnyx

API 키 불일치 감지

오류 메시지의 시크릿 스크러빙

OpenAI temperature 호환성

프로바이더 검증

다음 단계

시작하기

핵심 개념

가이드

CLI 참조

게이트웨이 API

대시보드

채널

프로바이더 및 모델

도구

메모리

워크플로우 및 SOP

크론 및 스케줄링

보안 및 감사

배포 및 운영

하드웨어

MCP 및 확장성

에코시스템

참조