Partner API PMF

Quina diferència hi ha entre una clau d'API de compte i una clau d'API de model?

La clau de l'API a nivell de compte (mg_partner_...) gestiona les claus de l'API del model mitjançant https://p-api.model-gate.com/api/v1/partner/* i recupera resultats asíncrons mitjançant https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Una clau d'API de model (mg_live_...) autentica les sol·licituds d'inferència mitjançant https://api.model-gate.com.

No envieu mai una clau del nivell de compte Partner API a un punt final d'inferència ni l'exposeu a les aplicacions del costat del client.

Quin comptador fa complir spend_limit?

El reiniciable usage comptador fa complir el límit. POST /api/v1/partner/keys/{key_public_id}/reset-usage esborra el comptador de claus. total_spent és la comptabilitat de tota la vida i mai no es reinicia.

Cada clau d'API Model té un saldo de compte independent?

No. Totes les claus de l'API de Model es gasten amb el saldo del compte de Model Gate. Els límits per clau i grup restringeixen l'ús sense dividir el saldo del compte en saldos secundaris.

Què passa quan es gira una clau de l'API del model?

El vell secret deixa de funcionar immediatament. La resposta de rotació conté el nou secret de text pla una vegada. Emmagatzemeu-lo de manera segura perquè Model Gate no torna a mostrar el secret complet.

Com es configuren les devolució de trucades?

Configura callback_url i girar callback_secret al perfil Model Gate. Els resultats de finalització asíncron s'envien quan existeix un URL de retorn de trucada. Es poden activar per separat els esdeveniments de límit de clau baix, límit de grup de claus i de saldo de compte baix; els seus llindars es configuren a les notificacions del perfil.

La devolució de trucada és duradora i independent del processament d'inferències. Cada esdeveniment porta un estable event_id que es manté sense canvis en els reintents i s'ha d'utilitzar per a la desduplicació del consumidor. Qualsevol HTTP 2xx resposta té èxit. El lliurament utilitza com a màxim 6 intents en total, amb reintents després de 5 segons, 30 segons, 2 minuts, 10 minuts i 1 hora; cada intent té un temps mort global de 15 segons. Els errors de transport, els temps d'espera i les respostes no 2xx es tornen a intentar, i després del sisè intent fallit, l'esdeveniment es marca failed sense cap altre intent automàtic. Mireu Devolució de trucades per al catàleg d'esdeveniments, càrregues decimals exactes, signatures, seguretat de destinació i detalls de lliurament.

Quant de temps es pot recuperar un resultat asíncron?

Un resultat asíncron roman disponible durant 24 hores GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Després de la caducitat, la sol·licitud i la resposta emmagatzemades se suprimeixen i el punt final torna 404.

Les mutacions de partner admeten un nou intent segur?

Sí. Cada Partner API POST, PATCH, i DELETE requereix Idempotency-Key. Torneu a provar la mateixa operació lògica amb la mateixa clau després d'un temps d'espera; durant 7 dies Model Gate retorna el resultat original sense tornar a executar la mutació. Es retorna la reutilització d'una clau per a una sol·licitud diferent 409.

Quant de temps està disponible l'historial de sol·licituds detallat?

A continuació es mostra l'historial de sol·licituds de socis detallat API_REQUESTS_HOT_RETENTION_DAYS (7 dies per defecte) i informa d'aquesta finestra a les metadades de resposta. Utilitzeu transaccions de saldo del compte amb pàgina del cursor per a una conciliació financera a llarg termini.