Partner API domande frequenti

Qual è la differenza tra una chiave API dell'account e una chiave API del modello?

La chiave API a livello di account (mg_partner_...) gestisce le chiavi API del modello tramite https://p-api.model-gate.com/api/v1/partner/* e recupera risultati asincroni tramite https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Una chiave API del modello (mg_live_...) autentica le richieste di inferenza tramite https://api.model-gate.com.

Non inviare mai una chiave Partner API a livello di account a un endpoint di inferenza né esporla in applicazioni lato client.

Quale contatore impone spend_limit?

Il resettabile usage il contatore impone il limite. POST /api/v1/partner/keys/{key_public_id}/reset-usage azzera il contatore delle chiavi. total_spent è una contabilità a vita e non si ripristina mai.

Ogni chiave Model API ha un saldo del conto separato?

No. Tutte le chiavi Model API spendono dal saldo dell'account Model Gate proprietario. I limiti per chiave e gruppo limitano l'utilizzo senza suddividere il saldo dell'account in saldi secondari.

Cosa succede quando una chiave API del modello viene ruotata?

The old secret stops working immediately. La risposta di rotazione contiene una volta il nuovo segreto in testo normale. Conservalo in modo sicuro perché Model Gate non visualizza nuovamente il segreto completo.

Come vengono configurati i callback?

Configura callback_url e ruotare callback_secret nel profilo Model Gate. I risultati del completamento asincrono vengono inviati quando esiste un URL di richiamata. Gli eventi opzionali con limite basso di chiave, limite di gruppo di chiavi e saldo del conto basso possono essere abilitati separatamente; le loro soglie sono configurate nelle notifiche del profilo.

La consegna della richiamata è duratura e indipendente dall'elaborazione dell'inferenza. Ogni evento porta con sé una stalla event_id che rimane invariato tra i tentativi e deve essere utilizzato per la deduplicazione del consumatore. Qualsiasi HTTP 2xx la risposta ha successo. La consegna utilizza al massimo 6 tentativi in ​​totale, con tentativi dopo 5 secondi, 30 secondi, 2 minuti, 10 minuti e 1 ora; ogni tentativo ha un timeout complessivo di 15 secondi. Vengono ritentati gli errori di trasporto, i timeout e le risposte non 2xx e dopo il sesto tentativo fallito l'evento viene contrassegnato failed senza ulteriori tentativi automatici. Vedere Richiamate per il catalogo eventi, payload in decimale esatto, firme, sicurezza di destinazione e dettagli di consegna.

Per quanto tempo è possibile recuperare un risultato asincrono?

Un risultato asincrono rimane disponibile per 24 ore GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Dopo la scadenza, la richiesta e la risposta archiviate vengono eliminate e l'endpoint viene restituito 404.

Le mutazioni del partner supportano i tentativi sicuri?

SÌ. Ogni Partner API POST, PATCH, E DELETE richiede Idempotency-Key. Riprovare la stessa operazione logica con la stessa chiave dopo un timeout; per 7 giorni Model Gate restituisce il risultato originale senza eseguire nuovamente la mutazione. Reusing a key for a different request returns 409.

Per quanto tempo è disponibile la cronologia dettagliata delle richieste?

Segue la cronologia dettagliata delle richieste dei partner API_REQUESTS_HOT_RETENTION_DAYS (impostazione predefinita 7 giorni) e segnala tale finestra nei metadati della risposta. Utilizzare le transazioni del saldo del conto con impaginazione del cursore per la riconciliazione finanziaria a lungo termine.