Viite · Rate limitit
Photta API:n rate limitit ja miten pollausta tehdään siististi
Yhdellä lauseella
Photta API sallii 600 pyyntöä minuutissa per API-avain kiinteässä aikaikkunassa. Koodi 429 sisältää otsakkeen Retry-After: 30. Pollaa työtä 3 sekunnin välein; rinnakkaisen työn määrää rajoitetaan tilauksen mukaan.
- Rajoitukset: 600 pyyntöä/min
- Retry-After: Retry-After: 30s
- Käsittely: asynkroninen, polling
Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu
Julkaistut rajat
Pyyntömäärä, aikaikkuna, uudelleenyritys, kuvakoko ja tiedostomuodot dokumentaation mukaisesti.
Rajoitukset
- 600 pyyntöä minuutissa per API-avain (Kiinteä aikaikkuna; rajoitus on sama kaikissa tilauksissa)
- Vastaus 429 sisältää otsakkeen Retry-After: 30 sekuntia
- Enintään 10 MB per kuva
- Formaatit: JPEG, PNG, WebP
- Rinnakkaiset eräajot per tilaus: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Vain polling — API ei lähetä webhookeja.
Rinnakkainen työ tilauksen mukaan
Kuinka monta erää voi olla käynnissä samanaikaisesti ennen kuin pyyntö palauttaa koodin 409.
Käynnissä olevat erät per tilaus
Free
Rinnakkaiset: 1
Hobby
Rinnakkaiset: 2
Seller
Rinnakkaiset: 3
Brand
Rinnakkaiset: 4
Studio
Rinnakkaiset: 6
Rajojen sisällä pysyminen
Kiinteä aikaikkuna
Raja lasketaan per API-avain kiinteässä aikaikkunassa, ja se on sama jokaisessa tilauksessa. Kaksi avainta tarkoittaa kahta kiintiötä.
Pollaa 3 sekunnin välein
Pollaus on ainoa valmistumissignaali — API ei lähetä webhookeja. 3 sekuntia on dokumentoitu väli; tiheämpi pollaus kuluttaa kiintiötäsi tyhjiin vastauksiin.
Käytä eksponentiaalista perääntymistä
Odotusajan 429-virheen jälkeen määrittää Retry-After-otsake sekunteina; kasvata tämän jälkeen aikaväliä jokaisella uudella epäonnistumisella sen sijaan, että yrittäisit uudelleen kiintein väliajoin.
Erillä on erilliset rajoitukset
Rate limit laskee pyyntöjä; rinnakkaisuusraja laskee käynnissä olevia töitä. Erä, joka ylittää rajan, palauttaa koodin 409, ei 429.
Kysymyksiä rate limiteistä
Mikä on rate limit?
600 pyyntöä minuutissa per API-avain kiinteässä aikaikkunassa. Dokumentaatio ilmoittaa saman luvun jokaiselle endpointille.
Kuinka usein työn tilaa tulisi kysyä (polling)?
3 sekunnin välein. Webhookeja ei ole, joten polling on dokumentoitu tapa selvittää työn valmistuminen.
Kuinka monta renderöintiä voi olla käynnissä samanaikaisesti?
Käynnissä olevien erien määrää rajoitetaan tilauksen mukaan: Free 1, Hobby 2, Seller 3, Brand 4 ja Studio 6. Rajan ylittyessä lähetys palauttaa koodin 409.
Mitä tehdä 429-virheen yhteydessä?
Lue Retry-After-otsake, odota kyseinen sekuntimäärä ja yritä uudelleen eksponentiaalisella perääntymisellä. Aseta työ jonoon sen sijaan, että hylkäisit sen.
Endpointit ja viitteet
Ominaisuudet
Virtuaalinen try-on API vaatteille
REST API, joka asettaa vaatteet tekoälymallinukkejen päälle. Asynkroninen, 1.5–4 minuutin generointi, 5 credits resoluutiolla 2K, 6 resoluutiolla 4K. cURL-, Node.js- ja Python-esimerkit.
LueOminaisuudet
Korujen try-on-API kaulakoruille, sormuksille, rannekoruille ja korvakoruille
Sovita kaulakoruja, sormuksia, rannekoruja ja korvakoruja AI-malleille RESTin kautta. 5 credits resoluutiolla 2K, sisäänrakennetut lähikuvamallit, heijastukset huomioiva renderöinti Photta-dokumentaation mukaisesti.
LueOminaisuudet
Ghost mannequin API näkymättömän mallinuken tuotekuviin
Tekoälypohjainen ghost mannequin -endpoint. Poista nukke vaatekuvasta ja säilytä sisäpuolen yksityiskohdat. 3D tai flat-lay, eräajo, 4 credits resoluutiolla 2K.
LueReferenssi
Ensimmäinen Photta-kuva alle viidessä minuutissa.
Rekisteröidy, luo API-avain, suorita ensimmäinen cURL-kutsusi, tee pollingia valmistumiseen asti ja tallenna tulos. Viisi vaihetta, dokumentoitu alusta loppuun.
LueReferenssi
Photta API -autentikointi
Miten autentikoidutaan Photta APIin: Authorization-otsake, avaimen etuliite, mistä avaimet luodaan ja miten avain kierrätetään turvallisesti.
LueReferenssi
Photta API:n hinnoittelu
Mitä kukin Photta API -endpoint maksaa creditseinä resoluutioilla 2K ja 4K, miten veloitus ja palautukset toimivat ja mitkä endpointit ovat ilmaisia. Ei kuvakohtaista rahahintaa.
LueReferenssi
Photta API -virheet
Täydellinen luettelo Photta API -virhetyypeistä statuskoodeineen, virheen rungon rakenne ja tiedot siitä, mitkä virheet kannattaa yrittää uudelleen.
LueReferenssi
Photta API -resurssipäätepisteet
Listaa mallinuket, asennot, taustat, jalkineet ja tuotemerkit, lataa omasi ja lue credits-saldosi. Haut jokaisen generoinnin takana.
Lue
Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu
Kokeile APIa viidessä minuutissa
Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.
- 600 pyyntöä/min
- Retry-After: 30s
- asynkroninen, polling