Słownik

Dlaczego limit rozmiaru obrazu na Bluesky to 2 000 000 bajtów

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •7 min czytania
Dlaczego limit rozmiaru obrazu na Bluesky to 2 000 000 bajtówDlaczego limit rozmiaru obrazu na Bluesky to 2 000 000 bajtów

TL;DR, szybka odpowiedź

7 min czytania

Bluesky ogranicza obraz w poście do 2 000 000 bajtów, a liczba ta jest zapisana jako maxSize w leksykonie app.bsky.embed.images. To dwa miliony bajtów, a nie 2 MiB, więc obraz, który menedżer plików opisuje jako 1,95 MB, już przekracza limit. Awatary, banery i miniatury kart linków mają połowę tej wartości, czyli 1 000 000 bajtów. Aplikacja Bluesky nigdy nie wysyła oryginalnego pliku: każdy obraz w poście koduje ponownie do JPEG o rozmiarze do 4 000 pikseli i szuka ustawienia jakości, które zmieści się w limicie.

Jaki jest limit rozmiaru obrazu na Bluesky?

Każdy obraz dołączony do posta na Bluesky może mieć najwyżej 2 000 000 bajtów, więc limit to dwa miliony bajtów, a nie 2 MiB, które większość menedżerów plików ma na myśli, pokazując "2 MB". Ta liczba nie jest ukryta w artykule pomocy. Znajduje się w schemacie protokołu, w app.bsky.embed.images, jako pole maxSize bloba obrazu:

"image": {
  "type": "blob",
  "description": "The raw image file. May be up to 2 MB, formerly limited to 1 MB.",
  "accept": ["image/*"],
  "maxSize": 2000000
}

Dwa miliony bajtów to 1,907 MiB. Wyeksportowany JPEG, który Finder w macOS pokazuje jako "1,9 MB", ma około 1 992 294 bajtów i ledwo się mieści, a plik pokazywany jako "2 MB" ma 2 097 152 bajty i już nie. W tej różnicy 97 152 bajtów kryje się większość nieporozumień wokół tego limitu.

Brzmienie leksykonu zachowuje historię. Mówi on, że blob "May be up to 2 MB, formerly limited to 1 MB", i dlatego tak wiele zewnętrznych poradników o rozmiarach nadal podaje 1 MB. Dwa lata temu miały rację i nikt do nich nie wrócił, by je poprawić.

Który typ przesyłania na Bluesky ma jaki limit?

Bluesky nie ma jednego limitu obrazu. Ma sześć limitów blobów zadeklarowanych w leksykonach i celowo różnią się one od siebie.

LeksykonCo przechowujemaxSizeaccept
app.bsky.embed.imagesObrazy w poście, do 42000000image/*
app.bsky.embed.galleryElementy galerii2000000image/*
app.bsky.embed.externalMiniatura karty linku1000000image/*
app.bsky.actor.profileAwatar1000000image/png, image/jpeg
app.bsky.actor.profileBaner1000000image/png, image/jpeg
app.bsky.embed.videoPlik wideo300000000video/mp4

W tej tabeli dwie rzeczy często zaskakują. Awatary i banery mają połowę limitu obrazu w poście i odrzucają wszystko poza PNG i JPEG, więc awatar w WebP, który bez problemu przejdzie jako obraz w poście, zostanie odrzucony w profilu. A blob wideo ma 300 000 000 bajtów, z opisem wskazującym, że był "formerly limited to 100mb", czyli według tego samego schematu co limit obrazu.

Nowszy leksykon app.bsky.embed.gallery dopuszcza maxLength 20 elementów, ale komentarz w jego schemacie każe klientom się powstrzymać: "The schema-level maxLength of 20 is a future-proof ceiling. Clients should currently enforce a soft limit of 10 items in authoring UIs." Starsze osadzenie app.bsky.embed.images pozostaje przy 4.

Telefon ze zdjęciem gotowym do udostępnienia, ilustracja etapu kompresji, który aplikacje wykonują przed przesłaniem.

Co aplikacja Bluesky robi z obrazem przed przesłaniem?

Oficjalny klient nigdy nie wysyła oryginalnego pliku. Zanim wywoła uploadBlob, edytor uruchamia compressImage z konfiguracją z src/lib/constants.ts:

export const IMAGE_SIZE_CONFIG_POSTS = {
  maxDimension: 4000,
  maxSize: 2000000,
};

Ta funkcja nie sprawdza, czy plik jest już wystarczająco mały. Koduje go ponownie bezwarunkowo, zawsze do JPEG, i wyszukiwaniem binarnym szuka poziomu jakości, który zejdzie poniżej 2 000 000 bajtów. Zaczyna od jakości 51, idzie w górę, jeśli wynik się mieści, a w dół, jeśli nie, i kończy, gdy okno wyszukiwania się zamknie.

Gdy obraz nie daje się skompresować, kod odmawia dalszego obniżania jakości. Komentarz w źródle wyjaśnia tę zasadę: "binary search will check 51, 26, 13(rounded). We don't want to go below 25, so if we've halved to 13, reset the loop and reduce the image dimensions instead." Każdy reset mnoży roboczy wymiar przez 0,8, co sprowadza 4000 do 3200, potem 2560, potem 2048, a potem około 1638 pikseli. Cztery resety to maksimum, a dalej przesyłanie kończy się błędem Unable to compress image.

Z tego, że każdy obraz w poście jest ponownie kodowany do JPEG, wynikają trzy konsekwencje. Znika przezroczystość, bo JPEG nie ma kanału alfa, więc logo PNG na przezroczystym tle dociera z jednolitym tłem. Ostry tekst i płaskie kolory dostają artefakty, których ten sam plik nie miałby na platformie przepuszczającej PNG. A twoje staranne ustawienia eksportu przepadają, bo klient sam wybiera poziom jakości, niezależnie od tego, co ustawisz. To samo ponowne kodowanie uzupełnia też pole aspectRatio na podstawie skompresowanego wyniku, a nie oryginału, i pole to zawiera dwie liczby całkowite o wartości co najmniej 1, a nie liczbę zmiennoprzecinkową.

Jak kompresor eskaluje, gdy sama jakość nie wystarcza
1
Start od jakości 51. Sprawdzenie, czy JPEG mieści się poniżej 2 000 000 bajtów.
2
Szukanie w dół. Przejście do jakości 26, a potem 13 po zaokrągleniu, jeśli plik nadal jest za duży.
3
Bez schodzenia poniżej 25. Reset wyszukiwania i zmniejszenie wymiaru o współczynnik 0,8.
4
Stopniowe zmniejszanie wymiaru. 4000 pikseli zmienia się w 3200, potem 2560, potem 2048, a potem około 1638.
5
Rezygnacja po czterech resetach. Powyżej tego pułapu przesyłanie kończy się błędem "Unable to compress image."
Edytor nigdy nie wysyła oryginalnego pliku: koduje go ponownie do JPEG i przechodzi przez tę drabinkę, zanim zgłosi błąd.

Dlaczego zbyt duży obraz czasem i tak się przesyła?

Bo przesłanie bloba i zapis rekordu to dwa różne żądania z dwoma różnymi limitami, a leksykon czyta tylko drugie z nich.

Endpoint com.atproto.repo.uploadBlob pilnuje własnego pułapu serwera, który w referencyjnym PDS domyślnie wynosi 5 * 1024 * 1024, czyli 5 242 880 bajtów, i można go zmienić zmienną środowiskową PDS_BLOB_UPLOAD_LIMIT. Przekrocz go, a strumień zostanie przerwany z komunikatem Max size of 5242880 bytes exceeded. Zmieść się poniżej, a blob zostanie przyjęty nawet przy 4 MB, czyli dużo powyżej 2 000 000 z leksykonu.

Leksykon wyjaśnia, gdzie odbywa się prawdziwe sprawdzenie. Jego opis brzmi: "The blob will be deleted if it is not referenced within a time window (eg, minutes). Blob restrictions (mimetype, size, etc) are enforced when the reference is created." Obraz 4 MB przesyła się więc poprawnie, leży w pamięci tymczasowej, nie przechodzi walidacji przy próbie dołączenia do posta i kilka minut później jest usuwany. Każdy, kto publikuje przez własnego klienta, a nie oficjalną aplikację, trafia na tę kolejność i bierze udane przesłanie za zielone światło.

Ten sam endpoint ma limit 1 000 punktów na dobę, co wyznacza twardy pułap liczby obrazów, jakie jedno konto może wysłać w ciągu 24 godzin. To jeden z kilku limitów, które warto znać razem z limitami zapisów w AT Protocol, jeśli publikujesz według harmonogramu.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Fotograf sprawdza ustawienia eksportu na ekranie aparatu, co ma znaczenie przy wyborze właściwych wymiarów przed publikacją.

Jakie wymiary eksportować na Bluesky?

Leksykon nie ogranicza wymiarów w pikselach. W app.bsky.embed.images nie ma minimalnej szerokości, maksymalnej wysokości ani wymaganych proporcji. Jedyna istniejąca liczba dotycząca wymiarów to własne maxDimension: 4000 klienta, a to wyzwalacz zmiany rozmiaru, a nie powód odrzucenia.

Praktyczna rada jest krótka. Eksportuj z dłuższym bokiem do 2 000 pikseli, aby klient nie miał powodu zmieniać rozmiaru ani mocno obniżać jakości. Sam używaj JPEG, bo aplikacja i tak skonwertuje plik do tego formatu, a twój enkoder jest lepiej dostrojony niż binarne szukanie jakości. Trzymaj plik poniżej około 1,8 MB, aby zostawić zapas na ponowne kodowanie. Jeśli potrzebujesz przezroczystości albo ostrego tekstu, przed przesłaniem spłaszcz obraz na wybranym kolorze tła, bo inaczej wybór zostawisz enkoderowi JPEG.

Tekst alternatywny nie ma w leksykonie żadnego zadeklarowanego limitu. Oficjalna aplikacja stosuje własne MAX_ALT_TEXT = 2000, a to reguła klienta, a nie protokołu, więc inni klienci ustalają własne. To odzwierciedla sposób, w jaki Bluesky traktuje linki i wzmianki, gdzie przesunięcia bajtów w facetach posta należą do protokołu, a wyświetlanie do klienta.

Jeśli przed stworzeniem szablonu eksportu porównujesz specyfikacje różnych sieci, obliczenia dla wymiarów obrazów na Instagramie wyglądają inaczej, bo Meta zmienia rozmiar po stronie serwera, zamiast zlecać to klientowi. A jeśli ustawiasz obrazy w kolejce z wyprzedzeniem, kompresja jest częścią planowania postów na Bluesky, niezależnie od tego, czy wykonujesz ją sam, czy zostawiasz klientowi.

Najczęściej zadawane pytania

Czy limit obrazu na Bluesky to 1 MB czy 2 MB?

To 2 000 000 bajtów. Wartość 1 MB była poprawna przed podniesieniem limitu, a leksykon nadal odnotowuje tę zmianę w opisie: "May be up to 2 MB, formerly limited to 1 MB." Poradniki podające 1 MB nie były aktualizowane od tamtej pory.

Ile obrazów mieści jeden post na Bluesky?

Cztery, zgodnie z "maxLength": 4 dla tablicy images w app.bsky.embed.images. Nowszy leksykon app.bsky.embed.gallery podnosi pułap schematu do 20, a jednocześnie każe klientom stosować miękki limit 10.

Czy Bluesky przyjmuje PNG i WebP?

Blob obrazu w poście deklaruje "accept": ["image/*"], więc każdy typ MIME obrazu przechodzi walidację protokołu. Oficjalna aplikacja konwertuje wszystko do JPEG przed przesłaniem, więc wysłany PNG dociera jako JPEG. Awatary i banery są bardziej rygorystyczne i przyjmują tylko image/png oraz image/jpeg.

Jaki jest limit rozmiaru awatara i banera na Bluesky?

Oba mają 1000000 bajtów w app.bsky.actor.profile, czyli połowę limitu obrazu w poście. Awatary generatorów kanałów i list w app.bsky.feed.generator oraz app.bsky.graph.list mają ten sam limit 1 000 000.

Dlaczego obraz się przesłał, a post się nie opublikował?

Endpoint przesyłania sprawdza limit blobów serwera, domyślnie 5 242 880 bajtów, a limit 2 000 000 z leksykonu jest sprawdzany później, gdy rekord odwołuje się do bloba. Obraz o rozmiarze między tymi liczbami przesyła się, a potem nie przechodzi przy publikacji.

Czy Bluesky kompresuje obrazy po przesłaniu?

Aplikacja kompresuje przed przesłaniem, a nie po nim. App View serwuje potem ze swojego CDN przeskalowane wersje miniatur i widoków pełnego rozmiaru, a leksykon zaznacza, że serwowany plik "May or may not be the exact original blob". Blob zapisany w twoim repozytorium to dokładnie to, co wysłał klient.

Czy Bluesky kompresuje obraz, który ma już mniej niż 2 000 000 bajtów?

Edytor uruchamia compressImage dla każdego obrazu w poście, niezależnie od rozmiaru początkowego, i koduje go ponownie do JPEG, zanim rozpocznie się szukanie jakości. Funkcja nie sprawdza najpierw rozmiaru pliku, więc nawet eksport, który się mieści, dostaje nową jakość JPEG wybraną przez aplikację.

Dlaczego przezroczysty PNG traci tło po publikacji na Bluesky?

JPEG nie ma kanału alfa, a aplikacja Bluesky konwertuje każdy obraz w poście do JPEG przed przesłaniem, więc przezroczyste tło PNG zostaje wypełnione jednolitym kolorem. Dzieje się tak nawet wtedy, gdy oryginalny eksport wyglądał poprawnie, bo compressImage koduje ponownie każdy obraz bez wyjątku.

Czy Bluesky zapisuje proporcje z oryginalnego pliku obrazu?

Aplikacja uzupełnia pole aspectRatio na podstawie skompresowanego pliku JPEG, a nie oryginału, bo proporcje są obliczane po zakończeniu zmiany rozmiaru i szukania jakości. Pole to przechowuje dwie liczby całkowite o wartości co najmniej 1, a nie proporcję dziesiętną.

Czy tekst alternatywny na Bluesky ma limit znaków?

Leksykon app.bsky.embed.images w ogóle nie ogranicza długości tekstu alternatywnego. Oficjalna aplikacja stosuje własną regułę po stronie klienta, MAX_ALT_TEXT = 2000, która jest wyborem aplikacji, a nie limitem protokołu, więc inni klienci mogą ustalić własny pułap.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły