APIMaster.ai

Controlli di instradamento per richiesta

Imposta il tetto rispetto al prezzo ufficiale, i tentativi e il tempo totale per una generazione di testo mediante intestazioni HTTP facoltative.

Controlli di instradamento per richiesta

Includere o escludere canali

Imposta i canali per una richiesta di generazione di testo, immagini o video. Puoi usare entrambe le intestazioni. Le esclusioni hanno la precedenza.

  • X-APIMaster-Include-Channels · Consenti solo i canali elencati.
  • X-APIMaster-Exclude-Channels · Escludi i canali elencati.

Ogni intestazione accetta fino a 64 interi positivi separati da virgole. Cerca i valori pubblici di channel_id per il modello. La chiave API e le preferenze della console determinano i canali disponibili. Il canale deve anche supportare l’operazione e i parametri della richiesta.

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

I tentativi e i percorsi di riserva rispettano l’ambito della richiesta. La generazione asincrona lo conserva e gli endpoint idempotenti lo includono nella verifica.

Le intestazioni non valide restituiscono 400 invalid_routing_parameter. Se nessun canale è idoneo, l’API restituisce 503 no_provider_within_channel_scope. Consultazione e download usano il canale dell’attività.

Ometti le intestazioni per consultare o scaricare un risultato. Gli endpoint incompatibili e il pool gestito FreeModel restituiscono 400 routing_controls_unsupported.

Esempi di generazione

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

Prezzo, tentativi e scadenze per il testo

Imposta il tetto rispetto al prezzo ufficiale, i tentativi e il tempo totale per una generazione di testo mediante intestazioni HTTP facoltative.

Intestazione Comportamento
X-APIMaster-Max-Official-Price-Ratio Rapporto massimo rispetto al prezzo ufficiale come numero positivo. 0.5 consente fino a metà del prezzo ufficiale e 1 fino al prezzo ufficiale pieno.
X-APIMaster-Max-Retries Numero massimo di tentativi aggiuntivi dopo il primo, come intero non negativo. 0 consente un solo tentativo. I cambi di fornitore e il ricorso al fornitore ufficiale contano.
X-APIMaster-Timeout-Ms Tempo totale in millisecondi come intero positivo a partire dalla ricezione al gateway. Include instradamento, tentativi e streaming. Si applica il limite temporale più breve.

Le intestazioni sono indipendenti. Le impostazioni omesse seguono le regole esistenti e le preferenze della console restano valide. Il tetto si applica ai prezzi unitari di input, output e cache applicabile. Il costo totale dipende dall’uso. Una volta avviata la trasmissione del contenuto, il gateway non ricomincia con un altro fornitore.

Endpoint supportati

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

Questi controlli si applicano alla generazione di testo. Gli endpoint di immagini, video e gli altri endpoint non supportati restituiscono 400 routing_controls_unsupported se ricevono queste intestazioni. I costi separati, come le chiamate agli strumenti, sono esclusi dal tetto per il testo.

Esempio

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

Errori

Un valore non valido restituisce 400 invalid_routing_parameter. Se manca un prezzo ufficiale verificabile, restituisce 400 official_price_unavailable. Se nessun fornitore rientra nel tetto, restituisce 503 no_provider_within_price_limit prima dell’invio. Alla scadenza restituisce 504 request_deadline_exceeded prima della risposta o chiude lo streaming già in corso.