Bayiler/Sağlayıcı yönlendirme

Sağlayıcıları ve sıralarını seçme

Bir modele birden fazla sağlayıcı hizmet verebilir; örneğin deepseek-v4.1-flash modeline deepseek, opencode veya volcengine hizmet verebilir. Platform varsayılan olarak sağlayıcıyı önceliğe göre seçer ve biri kullanılamadığında sıradakine geçer. Fiyat yalnızca modele bağlıdır, isteğe hangi sağlayıcının hizmet verdiğine asla bağlı değildir. Bunu kendiniz yönetmek için istek gövdesine bir provider nesnesi ekleyin.

Bu sayfadaexpand_more

provider alanlarılink

only

Yalnızca listelenen sağlayıcıları kullanır, örneğin {"only": ["deepseek"]}.

ignore

Listelenen sağlayıcıları hiçbir zaman kullanmaz, örneğin {"ignore": ["opencode"]}.

order

Listelenen sağlayıcıları bu sırayla dener; bir sağlayıcı kullanılamıyorsa sıradakine geçer. Listelemediğiniz sağlayıcılar yine de yedek olarak en sonda yer alır; onları hariç tutmak için order alanını only veya ignore ile birleştirin.

Sağlayıcı kimliklerilink

provider yalnızca birden fazla sağlayıcısı olan modellerde önem taşır. Claude, GPT, Gemini ve Grok gibi kapalı modeller yalnızca resmi sağlayıcıları tarafından sunulur ve tercih gerektirmez. Bugün kullanılan sağlayıcı kimlikleri aşağıda listelenmiştir. Belirli bir modeli sunan sağlayıcılar, modelin ayrıntı sayfasındaki “Sağlayıcılar” satırında (varsayılan öncelik sırasıyla) ve GET https://wokey.ai/api/models yanıtının providers alanında gösterilir.

Sağlayıcı kimliğiSağlayıcı
deepseekDeepSeek (resmi)
moonshotKimi (resmi, Moonshot AI)
zhipuGLM (resmi, Zhipu)
minimaxMiniMax (resmi)
volcengineVolcengine Ark: Doubao ile seçili DeepSeek, GLM, Kimi ve MiniMax modelleri
opencodeOpenCode Go: Tencent Hy4 ile seçili DeepSeek, GLM, Kimi ve MiniMax modelleri
ollamaOllama Cloud: seçili DeepSeek, GLM, Kimi ve MiniMax modelleri

Örneklerlink

cURL
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 ve Anthropic Python SDK’ları bilinmeyen üst düzey argümanları reddeder; bu yüzden provider alanını extra_body içinde gönderin.

Python
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)

Notlarlink

  • /chat/completions, /responses ve /messages bu alanı aynı biçimde kabul eder.
  • Bilinmeyen bir sağlayıcı kimliği 400 invalid_request_error döndürür. Modelin tüm sağlayıcılarını dışlayan bir tercih 404 no_eligible_provider döndürür.
  • provider yalnızca seçimi daraltır. API anahtarında ayarlı sağlayıcı kısıtlamasıyla birlikte uygulanır ve anahtarın dışladığı bir sağlayıcıyı yeniden etkinleştiremez.
  • Prompt önbelleğini korumak için, başka bir sağlayıcıya geçmiş bir konuşma order içindeki ilk sağlayıcıya geri dönmek yerine orada kalır.
  • provider, platforma yönelik bir yönlendirme talimatıdır ve hiçbir zaman upstream’e iletilmez.