API 요청을 위한 실행 제공자 선택하기
ShareAI 제공자 객체를 사용하여 모델 제작자와 독립적으로 모든 네 가지 추론 엔드포인트에서 실행 제공자를 선택하세요.
이 페이지에서
설정 model 정확한 크리에이터 기반 식별자로. 추가 provider 요청을 실행할 자격이 있는 인프라를 제한하거나 정렬하려는 경우. 이를 생략하면 기본 가격 오름차순 정책이 사용됩니다.
하나의 제공자 사용#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'only': ['shareai'], 'allow_fallbacks': False}, 'model': 'openai/gpt-5.4', 'messages': [{'role': 'user', 'content': 'Explain model routing in one sentence.'}]}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
선택한 모델에 표시된 제공자 태그를 사용하세요. only 는 엄격한 제한입니다: 대체 옵션을 허용하더라도 이 목록 외의 제공자는 허용되지 않습니다.
각 추론 엔드포인트에서 동일한 정책 사용#
| 엔드포인트 | 주요 입력 필드 | 지원되는 모델 선택 |
|---|---|---|
/api/v1/chat/completions | messages | 채팅 완료 |
/api/v1/responses | input | 응답 |
/api/v1/embeddings | input | 임베딩 |
/api/v1/images/generations | prompt | 이미지 생성 |
제공자 정책은 이러한 엔드포인트에서 동일한 의미를 가집니다. 모델과 제공자 기능은 다릅니다: 채팅 모델이 자동으로 임베딩 또는 이미지 모델이 되는 것은 아닙니다. 카탈로그에서 작업에 적합한 식별자를 복사하세요; 네이티브 엔드포인트는 구성된 지원이 필요합니다.
명명된 제공자 선호#
JSON
{
"provider": {
"order": [
"PROVIDER_A",
"PROVIDER_B"
],
"allow_fallbacks": false,
"sort": {
"by": "price",
"direction": "asc"
}
}
}
교체 PROVIDER_A 그리고 PROVIDER_B 실제 소문자 제공자 태그와 함께. 이 정렬된 목록과 대체 옵션이 비활성화된 경우, 나열된 제공자만 해당 순서대로 적격합니다. 첫 번째 제공자가 사용 불가능한 경우 두 번째 제공자가 여전히 선택될 수 있습니다.
자격 증명 제한 유지#
요청은 API 키의 허용된 모델 및 제공자를 좁힐 수 있습니다. 그러나 해당 권한 외의 접근 권한을 부여할 수는 없습니다. OAuth 동의, 결제 자격 및 장치 가용성은 계속 적용됩니다.
다음#
마지막 업데이트: 2026년 9월 16일