그룹 고정

모든 모델은 하나 이상의 제공자 그룹이 제공하며 그룹마다 가격이 있습니다. 기본적으로 키는 auto를 쓰며 요청마다 가장 싸고 살아 있는 그룹으로 갑니다.

고정은 이를 모델별로 덮어씁니다. 쓸 그룹을 직접 고르고, 과금은 그 요율로 묶입니다.

각 모델 페이지의 Group Pricing 아래에 입력과 출력 가격이 붙은 모든 그룹이 나옵니다. 모델 목록의 할인 배지는 가장 싼 그룹을 반영합니다.

API 키, 키를 만들거나 수정하고 그룹 선택기를 여세요. 모델을 검색해 누르고, 싼 순으로 정렬된 그룹을 하나 이상 고르세요. 건드리지 않은 모델은 auto로 남습니다.

고정한 모델은 위쪽에 정렬되며 그룹 수를 보여주는 배지가 붙습니다. Clear all은 키를 auto로 되돌립니다. 키 목록에서는 고정한 키가 auto +N으로 표시됩니다.

레인을 하나씩 선택하는 대신, 모델의 두 손잡이 가격 범위를 드래그하면 해당 범위에 요금이 들어오는 공급자만 사용합니다. 이름이 아니라 가격으로 선택하므로 범위에 들어오는 새 공급자는 자동으로 포함됩니다.

가격 범위와 고정한 레인은 합집합으로 결합됩니다. 범위가 저렴한 공급자를 담당하고, 고정은 범위를 벗어나더라도 특정 고가 공급자를 예비 경로로 남깁니다. 라우팅은 여전히 가장 저렴한 것부터 시도하므로 예비 경로는 더 저렴한 모든 선택지가 실패했을 때만 사용됩니다.

자동으로 두면 모델이 일반적인 저가 우선 체인으로 돌아갑니다. 범위와 고정 설정은 저장된 채 비활성화되므로 자동을 끄면 이전 구성이 그대로 복원됩니다.

고정한 모델은 고정한 그룹 안에서만 싼 순서로 라우팅되며 오류가 나면 다음으로 넘어갑니다. 요청을 처리한 그룹의 요율로 과금됩니다.

고정과 관심 등록을 함께 쓰면 그룹의 가격 변동이나 다운을 바로 알 수 있습니다. 다음을 참고하세요: 알림

키를 바꾸지 않고 요청 하나만 고정하려면 정확한 그룹 이름을 담은 X-Group 헤더를 보내세요. 키의 고정과 auto 라우팅을 덮어씁니다. 이름은 Group Pricing에서 복사하세요.

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

헤더에는 그 키가 쓸 수 있는 그룹을 지정해야 하며, 그렇지 않으면 요청이 거부됩니다. 고정하지 않은 모델은 가장 싼 경로를 그대로 씁니다.

다른 제공자가 그 모델을 계속 제공하더라도 고정한 그룹이 모두 멈춘 경우, 요청은 일반적인 혼잡 메시지가 아니라 전용 오류로 실패합니다:

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

고정 범위를 넓히거나 해제하거나, 나중에 다시 시도하세요. 모델 자체는 살아 있습니다.