제공자 정책 참조
추론 요청에서 실행 제공자를 선택하기 위해 ShareAI 제공자 필드, 기본값, 제한 및 오류를 참조하세요.
이 페이지에서
선택적 provider 객체는 추론 요청의 최상위 수준에 속하며, model. 와 함께 사용됩니다. 빈 객체는 기본값을 사용합니다. 이는 제공자 원격 액세스 및 관리 자격 증명과는 별개입니다.
| 필드 | 유형 | 동작 |
|---|---|---|
only | 제공자 태그 배열 | 실행을 이러한 제공자로 제한하세요. |
ignore | 제공자 태그 배열 | 대체를 포함하여 이러한 제공자를 제외하세요. |
order | 제공자 태그 배열 | 제공자를 제공된 순서대로 우선 순위로 지정한 후 정렬을 적용하세요. |
allow_fallbacks | boolean; 기본값은 true입니다. | 다른 적격 제공자를 허용하세요. false와 비어 있지 않은 순서 목록이 있는 경우, 나열된 제공자만 남습니다. 순서가 없으면 첫 번째 순위 제공자만 남습니다. |
networks | 배열 | 제공자 유형을 커뮤니티, 회사 및/또는 ShareAI로 제한하세요. |
sort | 문자열 또는 객체 | 가격, 지연 시간 또는 처리량을 사용하거나 by 및 direction이 포함된 객체를 사용하세요. |
JSON
{
"provider": {
"ignore": [
"PROVIDER_TO_EXCLUDE"
],
"networks": [
"company",
"shareai"
],
"sort": {
"by": "throughput",
"direction": "desc"
},
"allow_fallbacks": true
}
}
실제 소문자 제공자 태그로 자리 표시자를 교체하거나 ignore 필드를 제거하세요. 네트워크 유형은 인프라 범주를 선택하며 모델 제작자를 식별하지 않습니다.
정렬 기본값#
| 정렬 | 기본 방향 | 명시적 역순 |
|---|---|---|
price | asc — 가장 낮은 것부터 | desc — 가장 높은 것부터 |
latency | asc — 가장 짧은 경과 시간부터 | desc — 가장 긴 것부터 |
throughput | desc — 초당 가장 많은 출력 토큰부터 | asc — 가장 적은 것부터 |
객체의 경우, by 이러한 이름 중 하나로 설정하고 direction 에 asc 또는 desc. 참조 측정 및 대체 방식.
검증 및 오류#
- JSON 불리언과 소문자 제공자 태그 배열을 사용하세요. 제공자 또는 정렬에 null을 보내지 마세요.
- 나열된 필드만 허용됩니다. 이는 완전한 OpenRouter 매개변수 구현이 아닙니다.
- 정책은 8 KiB로 제한됩니다. only, ignore 및 order 목록은 각각 최대 100개의 태그를 허용합니다.
- 잘못된 정책은 HTTP 400을 반환합니다. 금지된 자격 증명 범위는 HTTP 403을 반환합니다. 적격한 사용 가능한 제공자가 없으면 HTTP 503을 반환합니다.
최소 정책#
JSON
{
"provider": {
"sort": "price"
}
}
완전히 생략된 경우, 제공자 선택은 결정론적 가격 오름차순 순위로 기본 설정됩니다. 제약 조건은 항상 순위보다 먼저 적용됩니다.
마지막 업데이트: 2026년 9월 16일