리셀러/벤더 라우팅
벤더 및 순서 지정
하나의 모델을 여러 벤더가 제공할 수 있습니다. 예를 들어 deepseek-v4.1-flash는 deepseek, opencode, volcengine 중 하나를 통해 제공됩니다. 기본적으로 플랫폼이 우선순위에 따라 벤더를 고르고, 벤더를 사용할 수 없으면 다음 벤더로 넘어갑니다. 가격은 모델에만 따르며 어떤 벤더가 요청을 처리했는지와는 무관합니다. 직접 제어하려면 요청 본문에 provider 객체를 추가하세요.
이 페이지 내용expand_more
provider 필드link
only나열한 공급사만 사용합니다. 예: {"only": ["deepseek"]}.
ignore나열한 공급사는 사용하지 않습니다. 예: {"ignore": ["opencode"]}.
order나열한 공급사를 이 순서대로 시도하고, 공급사를 사용할 수 없으면 다음 공급사로 넘어갑니다. 나열하지 않은 공급사도 마지막 대체 수단으로 사용됩니다. 이를 제외하려면 order를 only 또는 ignore와 함께 사용하세요.
공급사 IDlink
provider는 공급사가 둘 이상인 모델에서만 의미가 있습니다. Claude, GPT, Gemini, Grok 같은 비공개 모델은 공식 공급사만 제공하므로 따로 지정할 필요가 없습니다. 현재 사용 중인 공급사 ID는 아래와 같습니다. 특정 모델을 제공하는 공급사는 모델 상세 페이지의 공급사 항목(기본 우선순위 순)과 GET https://wokey.ai/api/models의 providers 필드에 표시됩니다.
| 공급사 ID | 공급사 |
|---|---|
| deepseek | DeepSeek(공식) |
| moonshot | Kimi(공식, Moonshot AI) |
| zhipu | GLM(공식, Zhipu) |
| minimax | MiniMax(공식) |
| volcengine | Volcengine Ark: Doubao 및 일부 DeepSeek, GLM, Kimi, MiniMax 모델 |
| opencode | OpenCode Go: Tencent Hy4 및 일부 DeepSeek, GLM, Kimi, MiniMax 모델 |
| ollama | Ollama Cloud: 일부 DeepSeek, GLM, Kimi, MiniMax 모델 |
예시link
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [
{ "role": "user", "content": "Hello" }
],
"provider": {
"order": ["volcengine", "deepseek"],
"ignore": ["opencode"]
}
}'OpenAI와 Anthropic의 Python SDK는 알 수 없는 최상위 인수를 거부하므로 provider는 extra_body로 전달하세요.
from openai import OpenAI
client = OpenAI(base_url="https://api.wokey.ai/v1", api_key="YOUR_API_KEY")
response = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Hello"}],
extra_body={"provider": {"only": ["deepseek"]}},
)
print(response.choices[0].message.content)참고 사항link
- /chat/completions, /responses, /messages 모두 같은 형태로 받습니다.
- 알 수 없는 공급사 ID는 400 invalid_request_error를 반환합니다. 모델의 모든 공급사를 제외하는 설정은 404 no_eligible_provider를 반환합니다.
- provider는 선택 범위를 좁힐 뿐입니다. API 키에 설정된 공급사 제한과 함께 적용되며, 키에서 제외한 공급사를 다시 사용할 수는 없습니다.
- 프롬프트 캐시를 유지하기 위해, 다른 공급사로 옮겨 간 대화는 순서상 첫 번째 공급사로 돌아가지 않고 그 공급사에 머뭅니다.
- provider는 플랫폼에 대한 라우팅 지시이며 업스트림으로 전달되지 않습니다.