Pro API: rajat, virhekoodit ja hyvät käytännöt

Rajat

Jokaisella avaimella on kolme rajaa: samanaikaiset renderöinnit (oletuksena 2), lähetykset minuutissa (oletuksena 60) sekä halutessasi päivittäinen krediittikatto.

Rajan ylittyessä vastaus on 429 ja Retry-After-otsake sekunteina. Hylätty kutsu ei maksa mitään. Rajoissa käytetty päivä on UTC-päivä.

Oma korttikapasiteettimme on jaettu sovelluksen käyttäjien kanssa. Kun se on kuormittunut, renderöintisi siirtyvät vuokratuille GPU:ille samaan hintaan ja saman API:n kautta, muutamia kymmeniä sekunteja pidemmällä käynnistysajalla.

Virhekoodit

Koodi	error	Mitä se tarkoittaa ja mitä tehdä
400	champ prompt requis	Lisää prompt.
400	contenu_interdit	Sisältösuodatin hylkäsi promptin.
400	image_requise, inpaint_images_requises	Tila vaatii image_b64-kentän, ja inpaint-tilassa myös mask_b64-kentän.
401	cle_requise, cle_invalide	Otsake puuttuu tai avain on tuntematon.
402	credits_insuffisants	Saldo ei riitä tähän renderöintiin (hinta ilmoitetaan kentässä cost). Lataa saldoa sivustolla.
403	cle_desactivee, cle_revoquee, cle_expiree	Avain on poistettu käytöstä, peruutettu tai vanhentunut: luo uusi avain sovelluksessa.
403	licence_revoquee, licence_non_pro	Lisenssi peruutettu tai tili ei ole Pro-tili.
403	portee_manquante	Avaimelta puuttuu pyydetty käyttöoikeus, joka on nimetty kentässä portee.
403	lora_inconnu	Hahmo ei kuulu tähän tiliin.
404	media_indisponible	Tiedosto on poistunut: lähetä pyyntö uudelleen.
413	image_trop_lourde	Lähde­kuva tai maski ylittää 12 MB dekoodattuna.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	Raja on saavutettu, katso Retry-After.
429	plafond_credits_jour	Avaimen päivittäinen krediittikatto on saavutettu (plafond, depense, cout).
502	soumission_echouee, statut_echoue	Renderöintipuolen häiriö: yritä uudelleen muutaman sekunnin kuluttua.
503	licence_inverifiable	Tiliä ei voida tarkistaa juuri nyt: yritä uudelleen minuutin kuluttua.

Virhenimet ovat tarkat merkkijonot, jotka API palauttaa. Tee vertailu niihin eikä message-kenttään, jonka sanamuoto saattaa muuttua.

Hyvät käytännöt

• Pollaa 3 sekunnin välein, ei tiheämmin. Jono on jaettu, eikä sen pommittamisesta ole hyötyä kenellekään.
• Lataa tiedosto heti, kun tila on completed. Tiedostoa ei arkistoida.
• Kirjoita promptit englanniksi, ja videoiden kohdalla kuvaile liikettä pysäytyskuvan sijaan.
• Yksi avain per käyttötarkoitus, ja päivittäinen krediittikatto jokaiselle palvelimella sijaitsevalle avaimelle. Vuotanut avain, jolla on katto, maksaa sinulle yhden päivän, ei koko saldoa.
• Käsittele 429-vastaus normaalina, ei virheenä: odota Retry-After-ajan verran ja jatka.

Promptit kirjataan meidän puolellamme, kuten sovelluksessakin, turvallisuussyistä.