그룹 고정

모든 모델은 하나 이상의 제공자 그룹이 서비스하며 그룹마다 가격이 다릅니다. 기본적으로 키는 auto를 사용해 모든 요청이 현재 살아 있는 가장 저렴한 그룹으로 라우팅됩니다.

고정은 이를 모델별로 재정의합니다. 사용할 그룹을 정확히 고르면 과금이 해당 요율에 고정됩니다. 특정 제공자의 품질이나 리전, 변동하면 안 되는 요율이 필요할 때 유용합니다.

각 모델 상세 페이지의 Group Pricing에 그룹별 입력/출력 가격이 나열됩니다. 모델 목록의 할인 배지는 항상 가장 저렴한 그룹을 반영합니다.

API 키에서 키를 만들거나 편집한 뒤 그룹 선택기를 엽니다. 모델을 검색해 클릭하고 요율 배수와 함께 저렴한 순으로 정렬된 제공자 그룹을 하나 이상 체크하세요. 건드리지 않은 모델은 auto로 유지됩니다.

고정된 모델은 몇 개 그룹에 고정됐는지 보여주는 배지와 함께 맨 위로 올라오고, 모두 지우기는 키를 완전한 auto로 되돌립니다. 키 목록에는 고정된 키가 auto +N으로 표시됩니다.

고정된 모델은 고정한 그룹 안에서만 라우팅됩니다. 가장 저렴한 그룹을 먼저 시도하고 오류나 다운 시 자동으로 다음으로 넘어갑니다. 실제로 요청을 처리한 그룹의 요율로 과금됩니다.

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

키를 수정하지 않고 요청별로 고정할 수도 있습니다. 정확한 그룹 이름을 담은 X-Group 헤더를 보내면 됩니다. 해당 요청에 한해 키에 저장된 고정과 자동 라우팅보다 우선합니다. 모델의 그룹 요금표에서 아무 그룹 이름이나 복사하세요.

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"
  }
}

키의 고정을 넓히거나 제거하거나 나중에 다시 시도하세요. 모델 자체는 여전히 살아 있습니다.