Reseller/Anbieter-Routing

Anbieter und ihre Reihenfolge festlegen

Ein Modell kann von mehreren Anbietern bedient werden; deepseek-v4.1-flash etwa von deepseek, opencode oder volcengine. Standardmäßig wählt die Plattform einen Anbieter nach Priorität und wechselt zum nächsten, wenn einer nicht verfügbar ist. Der Preis hängt nur vom Modell ab, nie davon, welcher Anbieter die Anfrage bedient. Um das selbst zu steuern, ergänze im Request-Body ein provider-Objekt.

Auf dieser Seiteexpand_more

Felder von provider
Anbieter-IDs
Beispiele
Hinweise

Felder von providerlink

only

Nur die aufgeführten Anbieter verwenden, zum Beispiel {"only": ["deepseek"]}.

ignore

Die aufgeführten Anbieter nie verwenden, zum Beispiel {"ignore": ["opencode"]}.

order

Die aufgeführten Anbieter in dieser Reihenfolge versuchen und zum nächsten wechseln, wenn einer nicht verfügbar ist. Nicht aufgeführte Anbieter kommen weiterhin zuletzt als Fallback; um sie auszuschließen, kombiniere order mit only oder ignore.

Anbieter-IDslink

provider spielt nur bei Modellen mit mehr als einem Anbieter eine Rolle. Geschlossene Modelle wie Claude, GPT, Gemini und Grok werden nur von ihrem offiziellen Anbieter bedient und brauchen keine Präferenz. Die derzeit verwendeten Anbieter-IDs stehen unten. Welche Anbieter ein bestimmtes Modell bedienen, zeigt die Zeile „Anbieter“ auf der Detailseite des Modells (in der Standardreihenfolge) sowie das Feld providers von GET https://wokey.ai/api/models.

Anbieter-ID	Anbieter
deepseek	DeepSeek (offiziell)
moonshot	Kimi (offiziell, Moonshot AI)
zhipu	GLM (offiziell, Zhipu)
minimax	MiniMax (offiziell)
volcengine	Volcengine Ark: Doubao sowie ausgewählte Modelle von DeepSeek, GLM, Kimi und MiniMax
opencode	OpenCode Go: Tencent Hy4 sowie ausgewählte Modelle von DeepSeek, GLM, Kimi und MiniMax
ollama	Ollama Cloud: ausgewählte Modelle von DeepSeek, GLM, Kimi und MiniMax

Beispielelink

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

Die Python-SDKs von OpenAI und Anthropic lehnen unbekannte Argumente auf oberster Ebene ab, übergib provider deshalb in extra_body.

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)

Hinweiselink

/chat/completions, /responses und /messages akzeptieren es in derselben Form.
Eine unbekannte Anbieter-ID liefert 400 invalid_request_error. Eine Präferenz, die alle Anbieter des Modells ausschließt, liefert 404 no_eligible_provider.
provider schränkt die Auswahl nur ein. Es gilt zusammen mit einer am API-Key gesetzten Anbieterbeschränkung und kann keinen Anbieter wieder aktivieren, den der Key ausschließt.
Damit der Prompt-Cache erhalten bleibt, bleibt eine Unterhaltung, die zu einem anderen Anbieter gewechselt ist, dort, statt zum ersten Anbieter in order zurückzuwechseln.
provider ist eine Routing-Anweisung an die Plattform und wird nie an den Upstream weitergegeben.