APIMaster.ai

Kontrol perutean per permintaan

Tetapkan batas terhadap harga resmi, jumlah percobaan ulang, dan tenggat generasi teks melalui header HTTP opsional.

Kontrol perutean per permintaan

Sertakan atau kecualikan kanal

Tentukan cakupan kanal untuk permintaan pembuatan teks, gambar, atau video. Kedua header dapat digunakan bersama. Pengecualian diutamakan.

  • X-APIMaster-Include-Channels · Hanya izinkan kanal yang tercantum.
  • X-APIMaster-Exclude-Channels · Kecualikan kanal yang tercantum.

Setiap header menerima maksimal 64 bilangan bulat positif yang dipisahkan koma. Cari nilai channel_id publik model. Kanal yang dapat digunakan ditentukan oleh API key dan preferensi konsol. Kanal juga harus mendukung operasi dan parameter dalam permintaan.

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

Semua percobaan ulang dan pengalihan mengikuti cakupan ini. Pembuatan asinkron menyimpan cakupan dan endpoint idempoten memasukkannya ke pemeriksaan.

Header yang tidak valid mengembalikan 400 invalid_routing_parameter. Jika tidak ada kanal yang cocok, API mengembalikan 503 no_provider_within_channel_scope. Polling dan unduhan menggunakan kanal tugas yang sudah ada.

Abaikan header ini saat memeriksa atau mengunduh hasil. Endpoint yang tidak didukung dan kumpulan terkelola FreeModel mengembalikan 400 routing_controls_unsupported.

Contoh pembuatan

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

Harga, percobaan ulang, dan batas waktu teks

Tetapkan batas terhadap harga resmi, jumlah percobaan ulang, dan tenggat generasi teks melalui header HTTP opsional.

Header Perilaku
X-APIMaster-Max-Official-Price-Ratio Rasio maksimum terhadap harga resmi dalam bentuk angka positif. 0.5 mengizinkan hingga setengah harga resmi dan 1 hingga harga resmi penuh.
X-APIMaster-Max-Retries Jumlah maksimum percobaan tambahan setelah yang pertama, berupa bilangan bulat nonnegatif. 0 mengizinkan satu percobaan. Pergantian penyedia dan pengalihan ke penyedia resmi ikut dihitung.
X-APIMaster-Timeout-Ms Tenggat total dalam milidetik berupa bilangan bulat positif sejak permintaan diterima gateway. Tenggat mencakup perutean, percobaan ulang, dan streaming. Batas yang lebih pendek berlaku.

Setiap header dapat digunakan sendiri. Pengaturan yang tidak disertakan mengikuti kebijakan saat ini, dan preferensi penyedia di konsol tetap berlaku. Batas harga berlaku pada tarif satuan input, output, dan cache terkait. Total biaya bergantung pada pemakaian. Setelah konten mulai dialirkan, gateway tidak memulai ulang generasi pada penyedia lain.

Endpoint yang didukung

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

Kontrol ini berlaku untuk generasi teks. Endpoint gambar, video, dan endpoint lain yang tidak didukung mengembalikan 400 routing_controls_unsupported jika menerima header ini. Item yang ditagih terpisah, seperti panggilan alat, berada di luar batas harga teks.

Contoh

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

Kesalahan

Nilai yang tidak valid menghasilkan 400 invalid_routing_parameter. Jika harga resmi tidak dapat diverifikasi, API mengembalikan 400 official_price_unavailable. Jika tidak ada penyedia yang memenuhi batas harga, API mengembalikan 503 no_provider_within_price_limit sebelum pengiriman. Saat tenggat habis, API mengembalikan 504 request_deadline_exceeded sebelum respons dimulai atau mengakhiri streaming yang sedang berjalan.