Partner API Časté otázky

Aký je rozdiel medzi kľúčom API účtu a kľúčom API modelu?

Kľúč API na úrovni účtu (mg_partner_...) spravuje kľúče API modelu prostredníctvom https://p-api.model-gate.com/api/v1/partner/* a načítava asynchrónne výsledky prostredníctvom https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Model API kľúč (mg_live_...) overuje požiadavky na odvodenie prostredníctvom https://api.model-gate.com.

Nikdy neposielajte kľúč Partner API na úrovni účtu do inferenčného koncového bodu ani ho nevystavujte v aplikáciách na strane klienta.

Ktorý pult presadzuje spend_limit?

Resetovateľný usage počítadlo presadzuje limit. POST /api/v1/partner/keys/{key_public_id}/reset-usage vymaže počítadlo kľúčov. total_spent je celoživotné účtovníctvo a nikdy sa neresetuje.

Má každý kľúč API modelu samostatný zostatok na účte?

Nie. Všetky kľúče API modelu minú zo zostatku na účte Model Gate. Limity na kľúč a skupiny obmedzujú používanie bez rozdelenia zostatku na účte na podriadené zostatky.

Čo sa stane, keď sa otočí kľúč API modelu?

Staré tajomstvo okamžite prestane fungovať. Odpoveď na otočenie obsahuje nový tajný text otvoreného textu raz. Uložte ho bezpečne, pretože Model Gate už nezobrazuje úplné tajomstvo.

Ako sa konfigurujú spätné volania?

Konfigurovať callback_url a otáčať callback_secret v profile Model Gate. Výsledky asynchrónneho dokončenia sa odošlú, keď existuje adresa URL spätného volania. Voliteľné udalosti s nízkym kľúčom, limitom skupiny kľúčov a udalosťami s nízkym zostatkom účtu možno aktivovať samostatne; ich prahové hodnoty sú nakonfigurované v upozorneniach profilu.

Doručenie spätného volania je trvalé a nezávislé od spracovania záverov. Každé podujatie nesie stajňu event_id ktorý zostáva nezmenený počas opakovaných pokusov a musí sa použiť na deduplikáciu spotrebiteľov. Akýkoľvek HTTP 2xx odpoveď je úspešná. Doručenie využíva celkovo najviac 6 pokusov, pričom pokusy sa opakujú po 5 sekundách, 30 sekundách, 2 minútach, 10 minútach a 1 hodine; každý pokus má celkový časový limit 15 sekúnd. Chyby prenosu, časové limity a odpovede iné ako 2xx sa opakujú a po šiestom neúspešnom pokuse sa udalosť označí failed bez ďalšieho automatického opakovania. Pozri Spätné volania pre katalóg podujatí, užitočné zaťaženie na presné desatinné miesta, podpisy, bezpečnosť miesta určenia a podrobnosti o doručení.

Ako dlho je možné získať asynchrónny výsledok?

Asynchrónny výsledok zostáva k dispozícii počas 24 hodín GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Po uplynutí platnosti sa uložená požiadavka a odpoveď vymažú a vráti sa koncový bod 404.

Podporujú mutácie partnera bezpečný opakovaný pokus?

áno. Každých Partner API POST, PATCHa DELETE vyžaduje Idempotency-Key. Po uplynutí časového limitu zopakujte rovnakú logickú operáciu s rovnakým kľúčom; po dobu 7 dní Model Gate vráti pôvodný výsledok bez opätovného vykonania mutácie. Opätovné použitie kľúča pre inú požiadavku sa vráti 409.

Ako dlho je k dispozícii podrobná história žiadostí?

Nasleduje podrobná história žiadostí o partnerstvo API_REQUESTS_HOT_RETENTION_DAYS (predvolene 7 dní) a uvádza toto okno v metadátach odpovede. Použite kurzorovo stránkované transakcie zostatku účtu na dlhodobejšie finančné vyrovnanie.