Pomoč
Pomoč in referenca
Formati, omejitve, kode napak, obračun, zasebnost in rešitve pogostih težav.
Formati in omejitve
- Bere
- JPEG
- PNG
- WebP
- AVIF
- GIF
- TIFF
- BMP
- SVG
- Zapiše
- JPEG
- PNG
- WebP
- AVIF
- GIF
- TIFF
Animirani GIF in WebP ohranita animacijo, kadar ju samo stisnete ali pomanjšate; vse drugo deluje na prvi sličici. Fotografije HEIC iz telefonov niso podprte, razen če so kodirane kot AVIF. Slika ima lahko do 50 megapikslov oziroma 25, kadar jo obrezujete, urejate ali ji dodajate vodni žig.
| Paket | Brezplačno | Pro |
|---|---|---|
| Slik v skupini | 20 | 500 |
| Največja datoteka | 20 MB | 200 MB |
| Zahtev API na mesec | 1000 | 20.000 |
| Zahtev UI na mesec (API) | 100 | 2000 |
| Zahtev na minuto | 120 | 600 |
| Največja slika za povečavo | 1 MP | 2,25 MP |
| Strani na pregled spletnega mesta | 5 | 50 |
Kode napak
Napake API so JSON s kodo, sporočilom in request_id. V urejevalniku se iste napake prikažejo kot sporočilo ob sliki.
- 401unauthorized
- Ni ključa, napačen ali preklican ključ. Preverite glavo Authorization: Bearer in nato celoten ključ.
- 403forbidden
- Ključ deluje, a nima tega dovoljenja. Ustvarite ključ z dovoljenjem ali uporabite drugega.
- 403upgrade_required
- Možnost je del paketa Pro: slika za ozadje, logotip kot vodni žig.
- 429rate_limited
- Preveč zahtev v eni minuti. Počakajte toliko sekund, kot navaja Retry-After.
- 429quota_exceeded
- Mesečna kvota API je porabljena. Ponastavi se prvega v mesecu, Pro pa je ima več.
- 413file_too_large
- Datoteka presega omejitev velikosti vašega paketa.
- 415unsupported_format
- Datoteka ni slika, ki jo lahko preberemo: nepodprt format, poškodovana datoteka ali sploh ni slika.
- 422too_many_pixels
- Slika ima več slikovnih točk, kot jih obdelamo, ali več, kot jih povečevalnik sprejme v vašem paketu. Najprej jo pomanjšajte.
- 422password_protected
- Datoteka je PDF, ki pred odpiranjem zahteva geslo. Odstranite geslo v programu za PDF in datoteko pošljite znova.
- 400invalid_request
- Možnost ima vrednost, ki ni dovoljena. Sporočilo navede, katera.
- 422fetch_failed
- Naslova, ki ste ga navedli, nismo mogli prenesti ali naložiti v vašo shrambo. Biti mora javen, odgovoriti v 15 sekundah in biti pod omejitvijo velikosti.
- 503busy
- Strežnik je polno zaseden ali pa je funkcija izklopljena zaradi vzdrževanja. Poskusite znova po sekundah iz Retry-After.
- 507storage_full
- Naša shramba rezultatov je trenutno polna. Poskusite čez minuto ali zahtevajte sliko namesto povezave.
- 504timeout
- Obdelava slike je trajala predolgo. Običajen vzrok so zelo velike slike v formatu AVIF ali s številnimi urejanji.
- 404not_found
- Datoteka, opravilo ali prednastavitev ne obstaja ali je potekla. Rezultati in opravila se hranijo eno uro.
- 409conflict
- Dosežena je omejitev števila, na primer shranjenih cevovodov.
- 500internal
- Naša napaka. Poskusite znova; če se ponovi, nam pošljite request_id.
Obračun in kvote
Spletno mesto je v okviru zgornjih omejitev brezplačno in brez računa. Pro zviša omejitve in doda nekaj možnosti; na voljo je kot mesečna ali letna naročnina, upravljate ali prekličete pa ga na strani računa.
API ima mesečno kvoto zahtev na račun, ki si jo delijo vsi njegovi ključi in strežnik MCP. Ena zahteva je en kredit ne glede na možnosti; opravilo šteje enega na sliko, pregled spletnega mesta pa enega na pretvorjeno sliko. Uporaba spletnega mesta se ne šteje v kvoto API. Vsak odgovor API v glavah X-Quota-Used in X-Quota-Limit pove, kje ste, stran računa pa prikaže zadnjih 30 dni po končnih točkah.
Preklicana naročnina ohrani Pro do konca že plačanega obdobja. Vračila so opisana na strani o vračilih.
Zasebnost in hramba
Vaša slika se naloži po šifrirani povezavi in obdela na naših strežnikih. Naložene datoteke ne hranimo: obstaja le kot začasna datoteka med obdelavo.
Rezultat se shrani samo, kadar namesto slike zahtevate povezavo, za največ eno uro in pod naključnim naslovom, ki ga ni mogoče uganiti. Izbrišete ga lahko prej. Z deliver_to gre rezultat neposredno v vašo shrambo in ga sploh ne shranimo.
Vsi modeli (odstranjevanje ozadja, povečava, prepoznavanje besedila) tečejo na naših strežnikih iz datotek na našem disku. Nobena slika in nobeno iz nje prebrano besedilo se ne pošlje drugemu podjetju. Slike se nikoli ne uporabljajo za učenje.
Podatki o fotoaparatu in lokacija se iz rezultatov privzeto odstranijo; lahko jih ohranite. Naš dnevnik zahtev beleži končno točko, stanje in trajanje, nikoli imen datotek ali naslovov.
Odpravljanje težav
Moja datoteka ni sprejeta.
Preverite seznam formatov zgoraj. Fotografije iz iPhona so pogosto HEIC: izvozite jih kot JPEG ali kamero nastavite na »Najbolj združljivo«.
Rezultat je večji od izvirnika.
To se zgodi pri pretvorbi učinkovitega formata v manj učinkovitega (AVIF v PNG) ali v načinu brez izgub. Poskusite nižjo kakovost, drug format ali pametni način.
Ciljna velikost ni bila dosežena.
Znižamo kakovost in nato mere, a se ustavimo, preden slika postane neuporabna. Sporočilo pokaže najmanjšo velikost, ki smo jo dosegli. Dovolite večji cilj ali sliko najprej pomanjšajte.
Barve so se rahlo spremenile.
Fotografije v širokem barvnem prostoru so odvisne od barvnega profila. Na zavihku Napredno nastavite Metapodatke na »Samo barvni profil« ali »Ohrani vse«.
Izrez ima grobe robove.
Pustite vklopljeno »Izboljšaj robove« in povečajte mehčanje robov. Nizek kontrast med motivom in ozadjem je za model najtežji primer.
Prepoznavanje besedila je napačno.
Izberite samo jezike, ki so na sliki, in uporabite ostro, ravno, dobro osvetljeno sliko s temnim besedilom na svetlem ozadju. Rokopis ni podprt.
Zahteva ni uspela in jo želim prijaviti.
Uporabite kontaktni obrazec in dodajte request_id iz napake ali glavo X-Request-Id. Tako najdemo točno to zahtevo.
Še vedno ne gre?
Pišite nam prek kontaktnega obrazca. Če zahteva ni uspela, priložite njen request_id.