APIMaster.ai

Routing-Steuerung pro Anfrage

Legen Sie Preisobergrenze, Wiederholungslimit und Gesamtfrist für eine Textgenerierung über optionale HTTP-Header fest.

Routing-Steuerung pro Anfrage

Kanäle ein- oder ausschließen

Legen Sie den Kanalbereich für Text-, Bild- oder Videoanfragen fest. Sie können beide Header zusammen verwenden. Ausschlüsse haben Vorrang.

  • X-APIMaster-Include-Channels · Nur die aufgeführten Kanäle zulassen.
  • X-APIMaster-Exclude-Channels · Die aufgeführten Kanäle ausschließen.

Jeder Header akzeptiert bis zu 64 kommagetrennte positive Ganzzahlen. Rufen Sie die öffentlichen channel_id-Werte des Modells ab. API-Schlüssel und Konsoleneinstellungen bestimmen die verfügbaren Kanäle. Der Kanal muss außerdem den angefragten Vorgang und seine Parameter unterstützen.

curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"

Alle Wiederholungen und Ausweichversuche beachten den Bereich. Asynchrone Generierung speichert ihn. Endpunkte mit idempotenter Übermittlung beziehen ihn in die Prüfung ein.

Ungültige Header ergeben 400 invalid_routing_parameter. Passt kein Kanal, antwortet die API mit 503 no_provider_within_channel_scope. Abfragen und Downloads nutzen den ursprünglichen Kanal der Aufgabe.

Lassen Sie die Header beim Abfragen und Herunterladen eines Ergebnisses weg. Nicht unterstützte Endpunkte und der verwaltete FreeModel-Pool liefern 400 routing_controls_unsupported.

Beispiele zur Generierung

curl "https://apimaster.ai/v1/chat/completions" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Exclude-Channels: $TEXT_CHANNEL_ID" \
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with OK."}]}'

curl "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Include-Channels: $IMAGE_CHANNEL_ID" \
  -d '{"model":"gpt-image-2","prompt":"A blue ceramic cup on a white table","size":"1024x1024"}'

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Include-Channels: $VIDEO_CHANNEL_ID" \
  -d '{"model":"wan3.0-video-prime","prompt":"A flower sways in a light breeze","duration":2,"resolution":"480P"}'

Preise, Wiederholungen und Zeitlimits für Text

Legen Sie Preisobergrenze, Wiederholungslimit und Gesamtfrist für eine Textgenerierung über optionale HTTP-Header fest.

Header Verhalten
X-APIMaster-Max-Official-Price-Ratio Maximaler Anteil des offiziellen Preises als positive Zahl. 0.5 erlaubt höchstens die Hälfte des offiziellen Preises, 1 den vollen offiziellen Preis.
X-APIMaster-Max-Retries Zusätzliche Versuche nach dem ersten als nichtnegative Ganzzahl. Mit 0 wird einmal gesendet. Anbieterwechsel und der Ausweichversuch beim offiziellen Anbieter zählen mit.
X-APIMaster-Timeout-Ms Gesamtfrist in Millisekunden als positive Ganzzahl. Sie beginnt mit dem Eingang am Gateway und umfasst Routing, Wiederholungen und Streaming. Eine kürzere Plattformfrist hat Vorrang.

Jeder Header ist unabhängig. Bei fehlenden Headern gilt die bestehende Richtlinie. Die Anbietereinstellungen der Konsole gelten weiterhin. Die Preisgrenze gilt für die Einheitspreise von Eingabe, Ausgabe und gegebenenfalls Cache. Die Gesamtkosten hängen von der Nutzung ab. Nach Beginn der Ausgabe wird der Stream nicht bei einem anderen Anbieter neu gestartet.

Unterstützte Endpunkte

  • POST /v1/chat/completions
  • POST /v1/responses
  • POST /v1/messages
  • POST /v1beta/models/{model}:generateContent
  • POST /v1beta/models/{model}:streamGenerateContent

Diese Einstellungen gelten für Textgenerierung. Bild-, Video- und andere nicht unterstützte Endpunkte geben mit diesen Headern 400 routing_controls_unsupported zurück. Separat berechnete Leistungen wie Tool-Aufrufe fallen nicht unter das Textpreislimit.

Beispiel

curl https://apimaster.ai/v1/chat/completions \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Max-Official-Price-Ratio: 0.5" \
  -H "X-APIMaster-Max-Retries: 1" \
  -H "X-APIMaster-Timeout-Ms: 30000" \
  -d '{"model":"gpt-6.2-sol","messages":[{"role":"user","content":"Reply with OK."}]}'

Fehler

Ungültige Werte ergeben 400 invalid_routing_parameter. Fehlt der offizielle Vergleichspreis, folgt 400 official_price_unavailable. Ohne passenden Anbieter folgt vor dem Versand 503 no_provider_within_price_limit. Bei Fristablauf folgt vor Antwortbeginn 504 request_deadline_exceeded. Ein laufender Stream wird beendet.