중국 지역 프로바이더

GLM, MiniMax, Qwen/DashScope, Moonshot/Kimi, Qianfan, Doubao, Z.AI, Bailian의 지역 라우팅 설정 방법.

Revka는 중국의 주요 모델 벤더인 Zhipu GLM, Z.AI, MiniMax, Alibaba Qwen/DashScope, Moonshot/Kimi, Baidu Qianfan, ByteDance Doubao, Alibaba Bailian을 공식 지원합니다. 이 중 대부분은 두 가지 지역 배포를 제공합니다. CN 엔드포인트(중국 본토 데이터 센터, 중국 내부에서 일반적으로 낮은 레이턴시)와 글로벌/인터내셔널 엔드포인트입니다. Revka는 선택한 프로바이더 *별칭(alias)*에 따라 올바른 기본 URL을 자동으로 선택하므로, 지역을 전환할 때 URL을 직접 수정하는 대신 설정 한 단어만 바꾸면 됩니다.

이 페이지는 해당 모델 중 하나를 실행하거나, 배포를 CN 엔드포인트 또는 글로벌 엔드포인트로 라우팅하거나, API 키 대신 Qwen Code 또는 MiniMax 구독 토큰을 재사용하려는 경우에 참고하십시오. 전체 프로바이더 목록은 프로바이더 카탈로그를, 폴백 및 힌트 기반 라우팅은 라우팅, 안정성 및 튜닝을 참조하십시오.

빠른 시작

모든 중국 프로바이더는 동일한 3단계 패턴을 따릅니다. 프로바이더 별칭을 설정하고, API 키를 구성하고(설정 파일 또는 환경 변수), 모델을 선택합니다.

프로바이더 별칭을 선택합니다. 예를 들어 qwen(CN) 또는 qwen-intl(글로벌)을 사용합니다.
키를 설정합니다. 온보딩을 비대화형으로 실행하거나 프로바이더의 환경 변수를 설정합니다.
Terminal window
```
revka onboard --provider qwen --api-key "YOUR_DASHSCOPE_KEY"
# or
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_KEY"
```

모델을 선택하고 대화를 시작합니다.

default_provider = "qwen"
default_model    = "qwen-max"

echo "Hello" | revka agent

Zhipu GLM

glm 프로바이더는 OpenAI 호환 인터페이스를 통해 Zhipu AI의 GLM 모델을 연동합니다. GLM API 키는 Zhipu 고유의 id.secret 형식(예: abc123.xyz789)을 사용합니다. 이 프로바이더는 responses-API 폴백을 비활성화하므로 항상 /chat/completions를 사용하며 /responses를 검색하지 않습니다.

	CN	글로벌
Base URL	`https://open.bigmodel.cn/api/paas/v4`	`https://api.z.ai/api/paas/v4`
별칭	`glm-cn`, `zhipu-cn`, `bigmodel`	`glm`, `zhipu`, `glm-global`, `zhipu-global`
인증	Bearer (`id.secret`)	Bearer (`id.secret`)
환경 변수	`GLM_API_KEY`	`GLM_API_KEY`

# ~/.revka/config.toml — GLM Global
default_provider = "glm"
default_model    = "glm-4.7"
api_key          = "<id>.<secret>"

# GLM China (open.bigmodel.cn)
default_provider = "glm-cn"
default_model    = "glm-4.7"
api_key          = "<id>.<secret>"

Z.AI

Z.AI는 표준 GLM 엔드포인트와 별도의 경로(/api/coding/paas/v4)에서 Zhipu의 코딩 플랜 배포를 제공합니다. Z.AI 코딩 플랜 구독이 있는 경우 zai를 선택하고, 표준 GLM API를 사용하는 경우 glm을 선택하십시오.

	CN	글로벌
Base URL	`https://open.bigmodel.cn/api/coding/paas/v4`	`https://api.z.ai/api/coding/paas/v4`
별칭	`zai-cn`, `z.ai-cn`	`zai`, `z.ai`, `zai-global`, `z.ai-global`
인증	Bearer (`id.secret`)	Bearer (`id.secret`)
환경 변수	`ZAI_API_KEY`	`ZAI_API_KEY`

# ~/.revka/config.toml — Z.AI Global
default_provider = "zai"
default_model    = "glm-4.7"
api_key          = "<id>.<secret>"

Z.AI / GLM 프로바이더 설정

Z.AI와 GLM은 동일한 id.secret 키 형식을 사용하지만 엔드포인트와 환경 변수가 다릅니다. 다음 체크리스트를 참고하여 각 프로바이더를 구성하십시오.

키를 발급받습니다. Z.AI 또는 Zhipu(bigmodel.cn) 콘솔에 가입하여 키를 생성합니다. 형식은 항상 id.secret입니다.
적합한 별칭을 선택합니다. Z.AI 코딩 플랜은 zai/zai-cn, 표준 GLM API는 glm/glm-cn을 사용합니다. 본토 엔드포인트의 경우 -cn을 붙입니다.
해당 환경 변수를 설정합니다. Z.AI는 ZAI_API_KEY, GLM은 GLM_API_KEY를 사용합니다. 각 별칭 계열은 자신의 환경 변수만 읽습니다.

Revka에 연결하기 전에 curl로 검증합니다.

curl -X POST "https://api.z.ai/api/coding/paas/v4/chat/completions" \
  -H "Authorization: Bearer YOUR_ZAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-4.7","messages":[{"role":"user","content":"Hello"}]}'

Revka에서 정상 인식되는지 확인합니다.
Terminal window
```
revka status
echo "Hello" | revka agent
```

MiniMax

MiniMax는 글로벌과 CN 두 가지 배포를 제공합니다. 일부 MiniMax 모델은 role: system 메시지를 거부하므로, Revka는 모든 MiniMax 별칭에서 시스템 프롬프트를 첫 번째 사용자 턴에 병합합니다. 시스템 프롬프트에 전달 지침이 포함된 채널 대화에서는 해당 내용이 별도 메시지가 아닌 사용자 메시지로 통합된다는 점에 유의하십시오.

	CN	글로벌
Base URL	`https://api.minimaxi.com/v1`	`https://api.minimax.io/v1`
별칭	`minimax-cn`, `minimaxi`, `minimax-oauth-cn`, `minimax-portal-cn`	`minimax`, `minimax-intl`, `minimax-io`, `minimax-global`, `minimax-portal`
인증	Bearer	Bearer
환경 변수	`MINIMAX_OAUTH_TOKEN`, 그 다음 `MINIMAX_API_KEY`	`MINIMAX_OAUTH_TOKEN`, 그 다음 `MINIMAX_API_KEY`

# ~/.revka/config.toml — MiniMax Global
default_provider = "minimax"
default_model    = "MiniMax-Text-01"
api_key          = "YOUR_MINIMAX_API_KEY"

MiniMax 지역 라우팅

MiniMax 별칭은 엔드포인트를 자동으로 선택합니다. 인터내셔널로 매핑된 별칭은 api.minimax.io로, CN으로 매핑된 별칭은 api.minimaxi.com으로 라우팅됩니다. 글로벌 엔드포인트에는 minimax 또는 minimax-intl을, 중국 엔드포인트에는 minimax-cn 또는 minimaxi를 사용하십시오. api_url을 별도로 설정할 필요가 없습니다.

MiniMax OAuth (구독 토큰)

api_key = "minimax-oauth"는 리터럴 키가 아닌 자동 OAuth 토큰 확인을 트리거하는 플레이스홀더입니다. Revka는 이 경우 순서대로 MINIMAX_OAUTH_TOKEN, MINIMAX_API_KEY, 그리고 마지막으로 MINIMAX_OAUTH_REFRESH_TOKEN을 사용한 토큰 갱신 엔드포인트를 확인합니다. 갱신 호출의 지역은 별칭 또는 MINIMAX_OAUTH_REGION에서 가져옵니다.

default_provider = "minimax-oauth"
api_key          = "minimax-oauth"   # placeholder, not a literal key

export MINIMAX_OAUTH_TOKEN="..."          # preferred direct token
# or, to auto-refresh:
export MINIMAX_OAUTH_REFRESH_TOKEN="..."
export MINIMAX_OAUTH_REGION="global"      # or "cn"

변수	설명
`MINIMAX_OAUTH_TOKEN`	직접 OAuth 액세스 토큰 (우선 확인)
`MINIMAX_API_KEY`	표준 API 키 폴백
`MINIMAX_OAUTH_REFRESH_TOKEN`	캐시된 토큰 만료 시 자동 갱신 활성화
`MINIMAX_OAUTH_REGION`	`global` 또는 `cn` — 갱신 엔드포인트 선택
`MINIMAX_OAUTH_CLIENT_ID`	기본 OAuth 클라이언트 ID 재정의

갱신 엔드포인트는 https://api.minimax.io/oauth/token(글로벌)과 https://api.minimaxi.com/oauth/token(CN)입니다. 전체 OAuth 흐름은 OAuth 및 구독 프로바이더를 참조하십시오.

Qwen / DashScope

Alibaba의 Qwen 모델은 DashScope의 OpenAI 호환 엔드포인트를 통해 제공됩니다. CN, 인터내셔널, US의 세 가지 지역 배포와 Qwen Code CLI 구독자를 위한 OAuth 변형이 있습니다. Qwen에는 비전 기능(base64 이미지)이 활성화되어 있습니다.

지역	Base URL	별칭
CN	`https://dashscope.aliyuncs.com/compatible-mode/v1`	`qwen`, `dashscope`, `qwen-cn`, `dashscope-cn`
인터내셔널	`https://dashscope-intl.aliyuncs.com/compatible-mode/v1`	`qwen-intl`, `dashscope-intl`, `qwen-international`, `dashscope-international`
US	`https://dashscope-us.aliyuncs.com/compatible-mode/v1`	`qwen-us`, `dashscope-us`

직접 키 방식의 세 가지 변형은 모두 DASHSCOPE_API_KEY(Bearer)로 인증합니다.

# ~/.revka/config.toml — Qwen International
default_provider = "qwen-intl"
default_model    = "qwen-max"

export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_KEY"

Qwen Code OAuth

qwen-code(별칭 qwen-oauth) 변형은 직접 키 대신 Qwen Code CLI 구독을 재사용하며, 다른 구독 프로바이더와 유사하게 동작합니다. 플레이스홀더 키를 설정하면 Revka가 토큰을 자동으로 확인합니다.

default_provider = "qwen-code"
api_key          = "qwen-oauth"   # placeholder

변수	설명
`QWEN_OAUTH_TOKEN`	명시적 OAuth 액세스 토큰
`QWEN_OAUTH_REFRESH_TOKEN`	캐시된 토큰 만료 시 자동 갱신 활성화
`QWEN_OAUTH_RESOURCE_URL`	OAuth 세션에서 반환된 엔드포인트 재정의
`QWEN_OAUTH_CLIENT_ID`	기본 OAuth 클라이언트 ID 재정의

Revka는 Qwen Code CLI가 ~/.qwen/oauth_creds.json에 기록한 자격 증명도 자동으로 검색합니다. 리소스 URL이 제공되지 않으면 OAuth 변형은 CN 기본 URL로 폴백합니다. 전체 흐름은 OAuth 및 구독 프로바이더를 참조하십시오.

Moonshot / Kimi

Moonshot의 Kimi 모델은 CN과 인터내셔널 배포를 제공합니다. 별칭 매핑이 비대칭적으로 구성되어 있으므로 주의하십시오. 접미사 없는 moonshot 및 kimi 별칭은 CN 엔드포인트를 가리키며, 인터내셔널 엔드포인트에는 -intl/-global 별칭을 사용해야 합니다.

	CN	인터내셔널
Base URL	`https://api.moonshot.cn/v1`	`https://api.moonshot.ai/v1`
별칭	`moonshot`, `kimi`, `moonshot-cn`, `kimi-cn`	`moonshot-intl`, `moonshot-global`, `kimi-intl`, `kimi-global`
인증	Bearer	Bearer
환경 변수	`MOONSHOT_API_KEY`	`MOONSHOT_API_KEY`

# ~/.revka/config.toml — Kimi International
default_provider = "kimi-intl"
default_model    = "kimi-k2"
api_key          = "YOUR_MOONSHOT_API_KEY"

Qianfan / Baidu

Baidu의 Qianfan 플랫폼(구 Wenxin/ERNIE)은 단일 엔드포인트로 제공됩니다.

항목	값
Base URL	`https://qianfan.baidubce.com/v2`
별칭	`qianfan`, `baidu`
인증	Bearer
환경 변수	`QIANFAN_API_KEY`

default_provider = "qianfan"
default_model    = "ernie-4.5-turbo"
api_key          = "YOUR_QIANFAN_API_KEY"

Baidu가 다른 호스트로 계정을 라우팅하는 경우 api_url로 기본 URL을 재정의할 수 있습니다.

Doubao / Volcengine

ByteDance의 Doubao 모델은 Volcengine Ark 플랫폼에서 실행됩니다. 엔드포인트는 중국 본토에 위치합니다.

항목	값
Base URL	`https://ark.cn-beijing.volces.com/api/v3`
별칭	`doubao`, `volcengine`, `ark`, `doubao-cn`
인증	Bearer
환경 변수	`ARK_API_KEY`, 그 다음 `VOLCENGINE_API_KEY`, 그 다음 `DOUBAO_API_KEY`

default_provider = "doubao"
default_model    = "doubao-pro-32k"
api_key          = "YOUR_ARK_API_KEY"

Bailian

Alibaba Cloud Bailian(모델 스튜디오)은 전용 DashScope 코딩 호스트에서 제공됩니다. 이 프로바이더에는 비전 기능이 활성화되어 있습니다.

항목	값
Base URL	`https://coding.dashscope.aliyuncs.com/v1`
별칭	`bailian`, `aliyun-bailian`, `aliyun`
인증	Bearer
환경 변수	`BAILIAN_API_KEY`, 그 다음 `DASHSCOPE_API_KEY`

default_provider = "bailian"
default_model    = "qwen-max"
api_key          = "YOUR_BAILIAN_API_KEY"

Bailian은 DASHSCOPE_API_KEY로 폴백하므로, 계정이 두 서비스 모두 활성화된 경우 하나의 DashScope 키로 qwen과 bailian 별칭을 모두 사용할 수 있습니다.

CN vs 글로벌 별칭

모든 중국 프로바이더의 지역은 default_provider에 설정한 별칭만으로 결정됩니다. 아래 표는 각 별칭이 어느 엔드포인트로 매핑되는지를 나타내는 기준 참조표입니다.

프로바이더	CN 엔드포인트	CN 별칭	글로벌/인터내셔널 엔드포인트	글로벌/인터내셔널 별칭
GLM	`https://open.bigmodel.cn/api/paas/v4`	`glm-cn`, `zhipu-cn`, `bigmodel`	`https://api.z.ai/api/paas/v4`	`glm`, `zhipu`, `glm-global`, `zhipu-global`
Z.AI	`https://open.bigmodel.cn/api/coding/paas/v4`	`zai-cn`, `z.ai-cn`	`https://api.z.ai/api/coding/paas/v4`	`zai`, `z.ai`, `zai-global`, `z.ai-global`
MiniMax	`https://api.minimaxi.com/v1`	`minimax-cn`, `minimaxi`, `minimax-oauth-cn`, `minimax-portal-cn`	`https://api.minimax.io/v1`	`minimax`, `minimax-intl`, `minimax-io`, `minimax-global`, `minimax-portal`
Qwen / DashScope	`https://dashscope.aliyuncs.com/compatible-mode/v1`	`qwen`, `dashscope`, `qwen-cn`, `dashscope-cn`	인터내셔널: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` · US: `https://dashscope-us.aliyuncs.com/compatible-mode/v1`	`qwen-intl`, `dashscope-intl`, `qwen-international` · `qwen-us`, `dashscope-us`
Moonshot / Kimi	`https://api.moonshot.cn/v1`	`moonshot`, `kimi`, `moonshot-cn`, `kimi-cn`	`https://api.moonshot.ai/v1`	`moonshot-intl`, `moonshot-global`, `kimi-intl`, `kimi-global`
Qianfan / Baidu	`https://qianfan.baidubce.com/v2`	`qianfan`, `baidu`	(단일 엔드포인트)	—
Doubao / Volcengine	`https://ark.cn-beijing.volces.com/api/v3`	`doubao`, `volcengine`, `ark`, `doubao-cn`	(단일 엔드포인트)	—
Bailian	`https://coding.dashscope.aliyuncs.com/v1`	`bailian`, `aliyun-bailian`, `aliyun`	(단일 엔드포인트)	—

엔드포인트 재정의

지역 별칭은 표준 배포를 모두 포괄하지만, api_url을 사용해 기본 URL을 명시적으로 고정할 수도 있습니다. 이는 프라이빗 게이트웨이, 지역 미러, 또는 Alibaba/Baidu가 계정에 할당한 별도 호스트를 사용할 때 유용합니다.

default_provider = "qianfan"
api_url          = "https://your-qianfan-mirror.example.com/v2"
api_key          = "YOUR_QIANFAN_API_KEY"

적합한 별칭이 없는 경우 로컬, 자체 호스팅 및 커스텀 엔드포인트에서 설명하는 일반 custom: 접두사를 사용하십시오.

중국 지역 프로바이더

빠른 시작

Zhipu GLM

Z.AI

Z.AI / GLM 프로바이더 설정

MiniMax

MiniMax 지역 라우팅

MiniMax OAuth (구독 토큰)

Qwen / DashScope

Qwen Code OAuth

Moonshot / Kimi

Qianfan / Baidu

Doubao / Volcengine

Bailian

CN vs 글로벌 별칭

엔드포인트 재정의

관련 페이지

시작하기

핵심 개념

가이드

CLI 참조

게이트웨이 API

대시보드

채널

프로바이더 및 모델

도구

메모리

워크플로우 및 SOP

크론 및 스케줄링

보안 및 감사

배포 및 운영

하드웨어

MCP 및 확장성

에코시스템

참조