APIMaster.ai

Sterowanie routingiem dla pojedynczego żądania

Ustaw limit względem ceny oficjalnej, liczbę ponowień i łączny czas generowania tekstu przez opcjonalne nagłówki HTTP.

Sterowanie routingiem dla pojedynczego żądania

Uwzględnianie i wykluczanie kanałów

Określ zakres kanałów dla generowania tekstu, obrazu lub wideo. Możesz użyć obu nagłówków. Wykluczenia mają pierwszeństwo.

  • X-APIMaster-Include-Channels · Zezwalaj wyłącznie na wymienione kanały.
  • X-APIMaster-Exclude-Channels · Wyklucz wymienione kanały.

Każdy nagłówek przyjmuje do 64 dodatnich liczb całkowitych oddzielonych przecinkami. Sprawdź publiczne wartości channel_id modelu. Dostępność kanałów zależy od klucza API i ustawień konsoli. Kanał musi też obsługiwać żądaną operację i jej parametry.

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

Ponowienia i kanały zastępcze respektują ten zakres. Generowanie asynchroniczne go zapisuje, a punkty końcowe z idempotentnym wysyłaniem uwzględniają go przy sprawdzaniu.

Nieprawidłowy nagłówek zwraca 400 invalid_routing_parameter. Brak pasującego kanału zwraca 503 no_provider_within_channel_scope. Odczyt i pobieranie używają kanału zadania.

Pomiń nagłówki przy odczycie i pobieraniu wyniku. Nieobsługiwane punkty końcowe oraz zarządzana pula FreeModel zwracają 400 routing_controls_unsupported.

Przykłady generowania

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

Cena, ponowienia i limit czasu dla tekstu

Ustaw limit względem ceny oficjalnej, liczbę ponowień i łączny czas generowania tekstu przez opcjonalne nagłówki HTTP.

Nagłówek Działanie
X-APIMaster-Max-Official-Price-Ratio Maksymalna część ceny oficjalnej jako liczba dodatnia. 0.5 dopuszcza połowę ceny oficjalnej, a 1 pełną cenę oficjalną.
X-APIMaster-Max-Retries Maksymalna liczba dodatkowych prób po pierwszej jako nieujemna liczba całkowita. 0 pozwala na jedną próbę. Wliczają się zmiany dostawcy i przejście do oficjalnego dostawcy.
X-APIMaster-Timeout-Ms Łączny limit czasu w milisekundach jako dodatnia liczba całkowita od odbioru przez bramę. Obejmuje wybór trasy, ponowienia i przesyłanie strumieniowe. Obowiązuje krótszy limit.

Każdy nagłówek działa niezależnie. Pominięte ustawienia podlegają dotychczasowym regułom, a preferencje dostawców w konsoli nadal obowiązują. Limit dotyczy cen jednostkowych wejścia, wyjścia i odpowiedniej pamięci podręcznej. Łączna opłata zależy od użycia. Po rozpoczęciu przesyłania treści brama nie wznawia generowania u innego dostawcy.

Obsługiwane punkty końcowe

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

Sterowanie dotyczy generowania tekstu. Punkty końcowe obrazów, wideo i inne nieobsługiwane punkty zwracają 400 routing_controls_unsupported po otrzymaniu tych nagłówków. Oddzielnie rozliczane pozycje, takie jak wywołania narzędzi, nie wchodzą w limit cen tekstu.

Przykład

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

Błędy

Nieprawidłowe wartości zwracają 400 invalid_routing_parameter. Brak wiarygodnej ceny oficjalnej zwraca 400 official_price_unavailable. Jeśli żaden dostawca nie mieści się w limicie, przed wysłaniem pojawia się 503 no_provider_within_price_limit. Po upływie czasu brama zwraca 504 request_deadline_exceeded przed odpowiedzią lub kończy rozpoczęty strumień.