OpenCode Zen

Zen은 OpenCode의 선택적 사용량 기반 모델 서비스입니다. 다른 제공업체를 계속 사용할 수 있습니다. 무료 클라이언트가 무료 추론을 의미하지는 않습니다.

연결 및 모델 선택

1. 공식 콘솔 (opens in a new tab)에 로그인해 결제 설정을 확인하고 API 키를 복사합니다.
2. TUI의 /connect에서 OpenCode Zen을 선택하고 키를 입력합니다. 자격 증명을 커밋하지 마세요.
3. /models로 모델을 고르고 민감한 데이터가 없는 작은 요청과 사용 기록을 확인합니다.

모델 식별자는 opencode/<model-id>입니다. 이름을 추측하지 말고 현재 목록 (opens in a new tab)을 확인하세요. 기본값을 고정하려면 설정의 model에 확인된 ID를 넣습니다.

Zen을 연결한 뒤 이 프로젝트 설정으로 GPT 5.5를 선택합니다. 필요하면 표의 다른 사용 가능한 ID로 바꾸세요.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}

프로토콜 및 직접 API

API 접두사는 https://opencode.ai/zen/v1/입니다. 모델별로 OpenAI 어댑터의 responses, Anthropic의 messages, 호환 어댑터의 chat/completions 또는 Google 전용 모델 엔드포인트를 사용합니다. 아래 모델 엔드포인트 표를 따르세요. 내장 Zen 연결이 이를 처리하며 모든 모델이 Chat Completions를 사용하는 것은 아닙니다.

Jev는 https://opencode.ai/zen/v1/systemone에서 생성 텍스트 대신 구조화된 판단을 반환합니다. 질문 유형은 noul, choice, score입니다. 현재 모델 ID와 응답 형식은 아래 Jev 예제를 참고하세요.

모델 목록 및 엔드포인트

아래 표는 Zen 모델 ID, 엔드포인트와 토큰 가격을 보여 줍니다. 참고 표에 남아 있어도 지원이 종료된 모델이 있으므로 현재 목록에서 사용 가능 여부를 확인하세요. opencode/ 접두사는 클라이언트 설정에 사용하며, API를 직접 호출할 때는 접두사 없는 ID를 사용합니다.

Jev

터미널 환경의 OPENCODE_API_KEY에 Zen 키를 설정합니다. 이 예제는 요청의 긴급성을 판단합니다. noul은 예/아니요, choice는 이름 있는 선택지, score는 기준에 따른 평가입니다. 이 예제는 유료 모델을 호출합니다.

curl https://opencode.ai/zen/v1/systemone \
  -H "Authorization: Bearer $OPENCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "My payments have failed for three days and I am losing sales. Please help now.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this request require urgent attention?"
      }
    }
  }'

가격 및 지출 관리

입력, 출력, 캐시, 긴 컨텍스트와 결제 처리 비용은 아래 토큰 가격표와 콘솔에서 확인하세요. 무료 제공은 종료될 수 있고 데이터 조건도 다를 수 있습니다. 종료된 모델은 현재 목록을 기준으로 확인하세요. 세션 제목 생성도 작은 모델의 사용량으로 나타날 수 있습니다.

자동 충전은 잔액이 임계값 아래로 내려가면 결제 수단에 청구합니다. 금액을 변경하거나 기능을 끌 수 있습니다. 무인 실행 전에 실제 설정을 확인하세요.

월간 사용 한도는 작업 공간이나 구성원의 소비량을 제한하며 결제 거래 총액을 제한하지는 않습니다. 자동 충전 청구액이 사용 한도를 넘을 수 있으므로 잔액, 충전과 한도를 함께 확인하세요.

토큰 가격

가격은 100만 토큰당 미국 달러입니다. 입력, 출력, 캐시 읽기와 쓰기는 별도로 청구되며, 문맥 길이별 구간이 있으면 해당 행을 적용합니다. 대시는 무료라는 뜻이 아닙니다. DeepSeek V4 Flash Vision Exp 등에서는 이미지도 청구 대상 토큰이 됩니다.

무료 모델

아래 모델에는 무료 제공이 있습니다. 사용 가능 여부와 데이터 조건은 서로 다르며 무제한 또는 영구 무료를 뜻하지 않습니다. Jev는 구조화된 판단을 반환하므로 텍스트를 생성하는 코딩 모델을 대체하지 않습니다.

• Big Pickle
• MiMo-V2.5 Free
• Ling 3.0 Flash Fin Free
• Nemotron 3 Ultra Free
• Nemotron 3.5 Lightning Free
• Muse Spark 1.3 Contributor Free
• Jev 1.13 Free

비용 계산 예시

MiniMax M3에서 캐시 없는 입력 100,000토큰과 출력 20,000토큰의 비용은 0.1 × $0.30 + 0.02 × $1.20 = $0.054이며 기타 비용은 별도입니다. 재시도와 문맥 재전송은 사용량을 늘립니다. 명시된 결제 처리 수수료는 거래당 4.4% + $0.30이므로 콘솔에서 실제 청구를 확인하세요.

자동 충전

잔액이 $5 아래로 내려가면 Zen이 자동으로 $20을 충전합니다.

자동 충전 금액은 변경할 수 있습니다. 자동 충전을 완전히 비활성화할 수도 있습니다.

월간 한도

워크스페이스 전체와 팀의 각 구성원에 대해 월간 사용 한도를 설정할 수도 있습니다.

예를 들어 월간 사용 한도를 $20로 설정하면, Zen은 한 달에 $20를 초과해 사용하지 않습니다. 하지만 자동 충전이 켜져 있다면 잔액이 $5 아래로 내려갈 때 자동으로 충전되어, 실제 청구 금액은 $20를 넘을 수 있습니다.

지원 종료 모델

개인정보

선택한 모델의 현재 설명 (opens in a new tab)을 읽으세요. 상위 문서는 미국 호스팅과 예외가 있는 보관 정책을 설명하며 모든 모델의 데이터 미보관을 보장하지 않습니다.

예외에는 OpenAI·Anthropic API의 보관, 일부 무료 모델의 개선 목적 사용, NVIDIA 무료 엔드포인트의 체험 로그, Muse Spark Contributor의 학습 사용이 있습니다. NVIDIA 체험 안내는 개인 정보나 기밀 데이터를 보내지 말라고 명시합니다. 모델별 조건과 계약 기간을 확인하세요.

팀 및 개인 키

Admin은 모델, 구성원, 키와 결제를 관리하고 Member는 자신의 키만 관리합니다. 관리자는 지출 한도와 모델 비활성화를 설정할 수 있습니다. 비활성화한 모델 요청의 오류가 반드시 잘못된 키를 의미하지는 않습니다. 일시적인 무료 작업 공간이 영구 무료라는 뜻은 아닙니다.

자신의 OpenAI 또는 Anthropic 키를 쓰면 해당 토큰은 Zen이 아닌 제공업체가 직접 청구합니다. 사용량 비교 전에 결제 계정을 확인하세요.

역할

워크스페이스에 팀원을 초대하고 역할을 할당할 수 있습니다.

• Admin : 모델, 멤버, API 키, 결제를 관리
• Member : 자신의 API 키만 관리

Admin은 비용을 통제할 수 있도록 각 멤버의 월간 지출 한도도 설정할 수 있습니다.

모델 접근

Admin은 워크스페이스에서 특정 모델을 활성화하거나 비활성화할 수 있습니다. 비활성화된 모델로 보내는 요청은 오류를 반환합니다.

이는 데이터를 수집하는 모델의 사용을 비활성화하고 싶을 때 유용합니다.

자체 키 사용

Zen의 다른 모델도 계속 사용하면서, 자체 OpenAI 또는 Anthropic API 키를 사용할 수 있습니다.

자체 키를 사용하면 토큰 요금은 Zen이 아니라 provider가 직접 청구합니다.

예를 들어 조직에서 이미 OpenAI나 Anthropic 키를 가지고 있고, Zen이 제공하는 키 대신 그 키를 사용하고 싶을 수 있습니다.

문제 해결

401/403은 키·작업 공간·접근 권한, 모델 누락은 ID와 지원 종료, 한도 오류는 잔액과 지출 설정을 확인합니다. 네트워크와 문제 해결을 참고하세요.

관련 가이드

• 제공업체 설정
• 모델 선택
• 네트워크
• 문제 해결

문서 출처 (MIT)