İstek başına yönlendirme denetimleri
İsteğe bağlı HTTP üst bilgileriyle metin üretimi için resmî fiyat sınırını, yeniden deneme sayısını ve toplam süreyi belirleyin.
İstek başına yönlendirme denetimleri
Kanalları dahil etme veya hariç tutma
Metin, görsel veya video üretimi için kanal kapsamını belirleyin. İki başlık birlikte kullanılabilir. Hariç tutma önceliklidir.
X-APIMaster-Include-Channels· Yalnızca listelenen kanallara izin verin.X-APIMaster-Exclude-Channels· Listelenen kanalları hariç tutun.
Her başlık virgülle ayrılmış en fazla 64 pozitif tam sayı kabul eder. Modelin herkese açık channel_id değerlerini sorgulayın. Kullanılabilir kanalları API anahtarı ve konsol tercihleri belirler. Kanal, istekteki işlemi ve parametreleri de desteklemelidir.
curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"
Yeniden denemeler ve yedek rotalar bu kapsama uyar. Asenkron üretim kapsamı saklar. İdempotent gönderimi destekleyen uç noktalar kapsamı denetime dahil eder.
Geçersiz başlıklar 400 invalid_routing_parameter döndürür. Uygun kanal yoksa API, 503 no_provider_within_channel_scope döndürür. Sorgulama ve indirme mevcut görevin kanalını kullanır.
Sonucu sorgularken veya indirirken bu başlıkları atlayın. Desteklenmeyen uç noktalar ve yönetilen FreeModel havuzu 400 routing_controls_unsupported döndürür.
Üretim örnekleri
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"}'
Metin fiyatı, yeniden deneme ve süre sınırı
İsteğe bağlı HTTP üst bilgileriyle metin üretimi için resmî fiyat sınırını, yeniden deneme sayısını ve toplam süreyi belirleyin.
| Üst bilgi | Davranış |
|---|---|
X-APIMaster-Max-Official-Price-Ratio |
Resmî fiyata göre pozitif sayı olarak üst oran. 0.5 resmî fiyatın yarısına, 1 resmî fiyatın tamamına kadar izin verir. |
X-APIMaster-Max-Retries |
İlk denemeden sonraki en yüksek ek deneme sayısı, negatif olmayan tam sayı. 0 tek denemeye izin verir. Sağlayıcı değişiklikleri ve resmî sağlayıcıya geçiş de sayılır. |
X-APIMaster-Timeout-Ms |
Ağ geçidinin isteği aldığı andan itibaren milisaniye cinsinden toplam süre, pozitif tam sayı. Yönlendirme, yeniden denemeler ve akış bu süreye dahildir. Daha kısa süre sınırı uygulanır. |
Her üst bilgi bağımsızdır. Atlanan ayarlarda mevcut politika izlenir ve konsoldaki sağlayıcı tercihleri geçerlidir. Fiyat sınırı girdi, çıktı ve ilgili önbellek birim fiyatlarına uygulanır. Toplam ücret kullanıma bağlıdır. İçerik akmaya başladıktan sonra ağ geçidi üretimi başka bir sağlayıcıda baştan başlatmaz.
Desteklenen uç noktalar
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent
Bu denetimler metin üretimi için geçerlidir. Görsel, video ve desteklenmeyen diğer uç noktalar bu üst bilgileri aldığında 400 routing_controls_unsupported döndürür. Araç çağrıları gibi ayrı ücretlendirilen işlemler metin fiyat sınırının dışındadır.
Örnek
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."}]}'
Hatalar
Geçersiz değerler 400 invalid_routing_parameter döndürür. Doğrulanabilir resmî fiyat yoksa 400 official_price_unavailable döner. Sınırı karşılayan sağlayıcı yoksa gönderimden önce 503 no_provider_within_price_limit döner. Süre dolduğunda yanıt başlamadıysa 504 request_deadline_exceeded döner, başladıysa akış sonlandırılır.
