문서 검색...

문서를 검색하려면 입력을 시작하세요

플랫폼 가이드

그룹 고정

가장 싼 경로 대신 모델을 특정 제공자 그룹에 고정합니다.

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

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

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

모델 상세 페이지의 그룹 가격 표

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

키 편집기의 모델별 제공자 그룹 선택기

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

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

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

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

bash
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" }]
  }'

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

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

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

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