TL;DR, szybka odpowiedź
9 min czytaniaDodanie upload_type=resumable do POST /<IG_ID>/media zwraca id oraz uri na rupload.facebook.com, zamiast pobierania wideo z adresu URL. Samo przesyłanie to POST na ten host z nagłówkami Authorization OAuth, offset i file_size albo z nagłówkiem file_url dla pliku hostowanego. Meta ogranicza ten proces do aplikacji korzystających z Facebook Login for Business, nie publikuje progu rozmiaru, od którego jest on obowiązkowy, i nie dokumentuje sposobu wznowienia przerwanego transferu.
Czym jest wznawiane przesyłanie na Instagramie?
Meta nazywa to Instagram resumable upload, a jest to proces obejmujący dwa hosty: POST /<IG_ID>/media z upload_type=resumable tworzy kontener na graph.facebook.com i zwraca cel przesyłania, a następnie bajty trafiają na rupload.facebook.com w drugim żądaniu, nad którym masz kontrolę.
Domyślnie jest odwrotnie. Przy standardowym przesyłaniu przekazujesz video_url, a Meta pobiera plik od ciebie: "We will cURL your image using the passed in URL so it must be on a public server." Twój serwer odpowiada na żądanie robota Meta, a transfer kończy się powodzeniem lub błędem gdzieś poza twoim polem widzenia. Tryb wznawiany to odwraca. To ty otwierasz połączenie, wysyłasz bajty i dostajesz odpowiedź na ich temat.
Powód istnienia tego procesu Meta podaje na liście punktów końcowych w przewodniku Content Publishing, wraz z literówką: "upload_type=resumable Create a resumbable upload session to upload large videos from an area with frequent network interruptions or other transmission failures."
Sam parametr jest w dokumentacji media opisany jako opcjonalny i wrażliwy na wielkość liter: "An optional parameter for users want to upload video through the rupload protocol, values can be set to lowercase string value: resumable." Małe litery mają znaczenie. RESUMABLE nie jest udokumentowaną wartością.
- Przekazujesz video_url i czekasz, aż Meta pobierze plik
- Twój serwer odpowiada na żądanie robota Meta
- Transfer udaje się lub nie gdzieś poza twoim polem widzenia
- Samodzielnie otwierasz połączenie z rupload.facebook.com
- Wysyłasz bajty i ustawiasz nagłówki offset oraz file_size
- Odpowiedź o przesyłaniu dostajesz bezpośrednio
Co wysyła każdy krok procesu?
Cztery kroki, dwa hosty i inny schemat autoryzacji na każdym z nich.
| Krok | Host | Żądanie |
|---|---|---|
| 1. Otwarcie sesji | graph.facebook.com | POST /<IG_USER_ID>/media z media_type, upload_type=resumable, access_token |
| 2. Wysłanie bajtów | rupload.facebook.com | POST /ig-api-upload/<API_VERSION>/<IG_CONTAINER_ID> z Authorization, offset, file_size |
| 3. Sprawdzenie kontenera | graph.facebook.com | GET /<IG_CONTAINER_ID>?fields=status_code |
| 4. Publikacja | graph.facebook.com | POST /<IG_ID>/media_publish z creation_id |
Krok pierwszy różni się od standardowego tworzenia kontenera tym, czego w nim nie ma. Nie ma video_url, bo Meta nie ma jeszcze czego pobierać. Pełny kształt sesji reela wygląda tak:
POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?media_type=REELS
&upload_type=resumable
&caption=<IMAGE_CAPTION>
&collaborators=<COLLABORATOR_USERNAMES>
&cover_url=<COVER_URL>
&audio_name=<AUDIO_NAME>
&location_id=<LOCATION_PAGE_ID>
&thumb_offset=<THUMB_OFFSET>
&access_token=<USER_ACCESS_TOKEN>Odpowiedź zawiera drugie pole, którego standardowy kontener nie zwraca:
{
"id": "<IG_CONTAINER_ID>",
"uri": "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>"
}Użyj uri otrzymanego od Meta, zamiast samodzielnie składać ścieżkę. W kroku drugim wysyłasz na nie plik:
curl -X POST "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>" \
-H "Authorization: OAuth <USER_ACCESS_TOKEN>" \
-H "offset: 0" \
-H "file_size: Your_file_size_in_bytes" \
--data-binary "@Your_local_file_path.extension"Meta opisuje oba nagłówki liczbowe w jednym wierszu każdy. "offset is set to the first byte being upload, generally 0." "file_size is set to the size of your file in bytes." Plik hostowany całkowicie pomija treść żądania i przenosi źródło do trzeciego nagłówka:
curl -X POST "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>" \
-H "Authorization: OAuth <USER_ACCESS_TOKEN>" \
-H "file_url: <VIDEO_URL>"Sukces to dwa pola: {"success":true,"message":"Upload successful."}.
Dlaczego nagłówek autoryzacji na rupload jest inny?
Bo Meta zapisuje go inaczej dla każdego hosta, a przykłady stoją obok siebie na tej samej stronie. Wywołania graph.facebook.com w przewodniku Content Publishing używają -H "Authorization: Bearer <ACCESS_TOKEN>". Każde wywołanie rupload.facebook.com na tej samej stronie używa -H "Authorization: OAuth <ACCESS_TOKEN>".
Ten sam token, inna nazwa schematu. Meta tego nie wyjaśnia, a przykłady dla rupload nigdy nie pokazują Bearer. Skopiuj schemat z przykładu dla hosta, który wywołujesz.
Dwa kolejne szczegóły łatwo przeoczyć w blokach kodu. Opublikowane przez Meta polecenie curl dla kroku rupload zawiera zabłąkany znak odwrotnego apostrofu w adresie URL, między symbolem zastępczym identyfikatora kontenera a cudzysłowem zamykającym. To literówka w dokumentacji, a nie element składni. Ponadto lista parametrów kroku przesyłania w przewodniku Content Publishing urywa się w połowie zdania: zapowiada "the following parameters", podaje access_token, po czym kończy się pustym punktem. Pełna lista nagłówków istnieje tylko w dokumentacji punktu końcowego media, a nie w przewodniku.
Kiedy przesyłanie wznawiane jest wymagane, a nie opcjonalne?
Meta nigdy nie publikuje rozmiaru pliku, od którego staje się ono obowiązkowe, a uczciwa odpowiedź brzmi: jedyny twardy wymóg dotyczy procesu logowania, a nie pliku.
Przewodnik Content Publishing ogranicza cały proces jednym zdaniem: upload_type=resumable jest "Only for apps that have implemented Facebook Login for Business." Tabela wymagań na tej samej stronie potwierdza to, wymieniając adresy hostów według typu logowania. Instagram API with Instagram Login dostaje graph.instagram.com. Instagram API with Facebook Login dostaje graph.facebook.com i rupload.facebook.com z adnotacją "(For resumable video uploads)".
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Aplikacja zbudowana na Business Login for Instagram nie może więc w ogóle korzystać z przesyłania wznawianego. Wideo musi trafić przez video_url i pobranie przez Meta. To decyzja o architekturze logowania, podejmowana na długo przed przesłaniem pierwszego pliku, której nie da się zmienić dla pojedynczego żądania.
Tam, gdzie przesyłanie wznawiane jest dostępne, wskazówki Meta są jakościowe, a nie liczbowe. Warunkiem są "large videos from an area with frequent network interruptions or other transmission failures", bez żadnego progu w bajtach. Jedyne powiązane liczby, jakie Meta publikuje, to górne limity specyfikacji: reele do 300 MB i 15 minut, relacje do 100 MB i 60 sekund. Żadnego z nich nie opisano jako progu dla przesyłania wznawianego.
W praktyce: używaj przesyłania wznawianego zawsze, gdy plik źródłowy jest lokalny i nie leży jeszcze na CDN, bo alternatywa wymaga publicznego hostowania pliku na czas pobierania przez Meta. Najbardziej liczy się to przy długich materiałach, czyli tam, gdzie przesyłanie długich filmów na Instagram staje się kłopotliwe i gdzie testowane przez Meta limity długości reeli zwiększają rozmiary plików.

Jak właściwie wznowić przerwane przesyłanie?
Meta tego nie dokumentuje. To największa luka tej funkcji i znajduje się dokładnie pod jej nazwą.
Nagłówek offset to jedyny mechanizm sugerujący transfery częściowe, a oba miejsca, w których Meta go opisuje, wskazują tę samą wartość: "offset is set to the first byte being upload, generally 0." Nie ma udokumentowanego rozmiaru fragmentu, punktu końcowego informującego, ile bajtów serwer już ma, drugiego kształtu żądania do kontynuacji przerwanego transferu ani żadnego przykładu w dokumentacji Instagram Platform z niezerowym offsetem. Opublikowana sesja "wznawianego" przesyłania to jeden POST z całym plikiem i polem offset, które w przykładach zawsze wynosi zero.
Meta daje za to kontener, który przetrwa błąd na tyle długo, by spróbować od początku. Kontenery wygasają po 24 godzinach, a konto może utworzyć ich 400 w kroczącym okresie 24 godzin. Nieudany transfer kosztuje jeden kontener z tych 400, a nie jedną publikację z dziennego limitu, więc ponowne rozpoczęcie jest tanie w tym budżecie, który się liczy. Wszystko, co ustawiono w kolejce z wyprzedzeniem, też musi mieścić się w tych limitach, i dlatego zaplanowane posty na Instagramie częściej zawodzą na etapie kontenera niż publikacji.
Jak wygląda nieudane przesyłanie?
Błąd na hoście rupload nie wraca jako standardowy obiekt błędu Graph API. Wraca jako koperta debug_info z właściwym błędem zapisanym w środku jako tekst:
{
"debug_info": {
"retriable": false,
"type": "ProcessingFailedError",
"message": "{\"success\":false,\"error\":{\"message\":\"unauthorized user request\"}}"
}
}Najpierw odczytaj retriable. To pole mówi, czy ponowna próba jest warta kontenera. false oznacza, że transfer znów zakończy się tak samo, a wybrany przez Meta przykład, nieautoryzowane żądanie użytkownika, to właśnie taki błąd.
Błędy pojawiające się później, po stronie Graph API, korzystają ze zwykłych par kodu i podkodu.
| Objaw | Kod | Podkod | Komunikat |
|---|---|---|---|
| Przesyłanie nieudane bez podanej przyczyny | -1 | 2207053 | unknown upload error |
| Kontener wygasł przed publikacją | -2 | 2207020 | The media you are trying to access has expired. Please try to upload again. |
| Nie znaleziono kontenera przy publikacji | 24 | 2207008 | The media builder with creation id = {creation-id} does not exist or has been expired. |
| Publikacja zbyt wcześnie | 9007 | 2207027 | The media is not ready for publishing, please wait for a moment |
| Odrzucony format wideo | 352 | 2207026 | The video format is not supported. Please check spec for supported {video} format |
Meta wiąże 2207053 właśnie z tym procesem: "An unknown error occured during upload. Generate a new container and use it to try again. This should only affect video uploads."

Które błędy pojawiają się po udanym przesłaniu?
Te, które wynikają z przetwarzania, a zobaczysz je tylko dzięki odpytywaniu. Meta mówi wprost, że identyfikator kontenera niczego nie dowodzi: "Video uploads are asynchronous, so receiving a container ID does not guarantee that the upload was successful."
GET /<IG_CONTAINER_ID>?fields=status_code zwraca jedną z pięciu wartości.
status_code | Znaczenie podane przez Meta |
|---|---|
IN_PROGRESS | Kontener jest wciąż w procesie publikacji |
FINISHED | Kontener i jego obiekt multimedialny są gotowe do publikacji |
ERROR | Kontener nie ukończył procesu publikacji |
EXPIRED | Kontener nie został opublikowany w ciągu 24 godzin i wygasł |
PUBLISHED | Obiekt multimedialny kontenera został opublikowany |
Bezpieczna do publikacji jest tylko wartość FINISHED. Warto dopisać pole status obok status_code, bo Meta definiuje je jako szczegóły: "If status_code is ERROR, this value will be an error subcode."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Meta określa konkretną częstotliwość odpytywania: "We recommend querying a container's status once per minute, for no more than 5 minutes." Długi reel może po tym czasie nadal się przetwarzać, a Meta nie mówi, co wtedy zrobić. Sprawdzony wzorzec to dalsze odpytywanie w dłuższych odstępach, aż kontener się zakończy albo osiągnie 24-godzinny limit ważności. Tak samo trzeba zbudować planowanie reeli przez API i tak samo kontenery relacji działają na własnym 24-godzinnym zegarze.
Najczęściej zadawane pytania
Co robi upload_type=resumable w API Instagrama?
Tworzy kontener, który oczekuje, że samodzielnie wyślesz wideo na rupload.facebook.com, zamiast pozwolić Meta pobrać je z hostowanego przez ciebie video_url. Odpowiedź zawiera zarówno id, jak i uri wskazujące host przesyłania.
Który host obsługuje wznawiane przesyłanie na Instagramie?
rupload.facebook.com, pod ścieżką /ig-api-upload/<API_VERSION>/<IG_CONTAINER_ID>. Tworzenie kontenera, sprawdzanie statusu i publikacja pozostają na graph.facebook.com.
Jakich nagłówków wymaga żądanie rupload?
Authorization: OAuth <ACCESS_TOKEN> oraz offset i file_size dla pliku lokalnego albo file_url dla pliku już hostowanego publicznie. Pamiętaj, że przykłady dla rupload używają OAuth tam, gdzie przykłady Graph API używają Bearer.
Czy aplikacje korzystające z Instagram Login mogą używać przesyłania wznawianego?
Nie. Meta ogranicza upload_type=resumable do aplikacji, które wdrożyły Facebook Login for Business, i wymienia rupload.facebook.com tylko przy tym typie logowania.
Od jakiego rozmiaru pliku Instagram wymaga przesyłania wznawianego?
Meta nie publikuje takiego progu. Przewodnik zaleca ten tryb dla "large videos from an area with frequent network interruptions", nie podając rozmiaru, a sam parametr dokumentuje jako opcjonalny.
Jak wznowić przerwane przesyłanie na Instagramie?
Meta nie dokumentuje procedury wznawiania. Nagłówek offset istnieje, ale każdy opublikowany przykład ustawia go na 0, a żaden punkt końcowy nie informuje, ile bajtów serwer już otrzymał. Utwórz nowy kontener i zacznij od nowa.
Jak długo kontener przesyłania na Instagramie jest ważny?
Kontener wygasa 24 godziny po utworzeniu, niezależnie od tego, czy został opublikowany. Po upływie tego czasu dostaniesz kod -2, podkod 2207020, z komunikatem, że multimedia, do których próbujesz uzyskać dostęp, wygasły i trzeba przesłać je ponownie. Z tego samego powodu pole status_code zgłasza EXPIRED.
Jak często odpytywać o status kontenera na Instagramie?
Meta ogranicza swoją wskazówkę do raz na minutę przez najwyżej pięć minut. Długi reel może po tym czasie wciąż pokazywać IN_PROGRESS, a Meta nie opisuje dalszych kroków. W praktyce warto odpytywać dalej w dłuższych odstępach, aż kontener osiągnie FINISHED albo 24-godzinny limit ważności.
Co oznacza pole retriable w błędzie rupload?
To pierwsze pole do sprawdzenia w kopercie debug_info, którą rupload zwraca przy błędzie. Wartość false oznacza, że po ponownym wysłaniu transfer zakończy się tak samo, jak w przykładzie Meta z nieautoryzowanym żądaniem użytkownika. Sprawdzenie retriable przed ponowną próbą chroni przed zużyciem kolejnego kontenera na żądanie, które nie może się udać.
Czy identyfikator kontenera oznacza, że przesyłanie na Instagram się udało?
Sam identyfikator kontenera niczego nie dowodzi. Meta wprost stwierdza, że przesyłanie wideo jest asynchroniczne, więc otrzymanie identyfikatora nie gwarantuje powodzenia. Jedynym sposobem, by się upewnić, jest odpytywanie kontenera przez GET /<IG_CONTAINER_ID>?fields=status_code i czekanie na FINISHED przed publikacją.
Wykorzystaj to w praktyce z AdaptlyPost
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
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


Wymagania API Instagrama dla obrazów egzekwowane przez Meta przy przesyłaniu
Wymagania API Instagrama dla obrazów to tylko JPEG, maksymalnie 8 MB i proporcje od 4:5 do 1.91:1, a każde z nich ma własny kod błędu.


Limit zapytań API Instagrama to 4800 razy liczba wyświetleń
Meta ustala limit zapytań API Instagrama na 4800 wywołań na wyświetlenie w kroczącym okresie 24 godzin i raportuje użycie w X-Business-Use-Case-Usage.


Co naprawdę daje zakres instagram_business_content_publish
Zakres instagram_business_content_publish pozwala aplikacji tworzyć organiczne posty na Instagramie i przy każdym wywołaniu zależy od instagram_business_basic.
Powiązane artykuły


Wszystkie limity, jakie API Instagram Reels nakłada na wideo
API Instagram Reels ogranicza reela do 15 minut i 300 MB, a przyjmuje tylko MOV lub MP4. Pełna specyfikacja i błąd zwracany przy każdym naruszeniu.


Wszystkie wartości media_category w API Twittera i co umożliwiają
Parametr media_category w API Twittera ma osiem wartości, wyznacza limity rozmiaru i długości, a zła wartość wywołuje błąd dopiero przy publikacji posta.


Przesyłanie multimediów INIT APPEND FINALIZE w X API krok po kroku
Przesyłanie INIT APPEND FINALIZE w X API działa na trzech endpointach v2, numeruje segmenty od 0 do 999 i zwraca blok processing_info do odpytywania.

