DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
FREEDOM251

Freedom251 › Blog › Amazon Textract

Generated Video Delivery: Status-Gated Download URLs in Marketplace OCR Pipelines

By Freedom251 Team · · 6 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Create a download URL in your own backend, and only after two checks that are separate from each other: the provider job has reached a successful terminal state, and the marketplace user asking for the output is entitled to that specific record. The provider can confirm the first check. The second is an application decision, and your code has to enforce it every time someone requests a download.

Job success and user permission are different signals

A provider’s success status describes the job. It says an OCR run finished or a video was generated. It says nothing about whether the buyer, seller, or support agent who triggered the request may receive the result. Keep these in separate fields of your data model, so that a job-status change never silently becomes an access decision.

As an Amazon Associate I earn from qualifying purchases.

  • Provider job state answers: did the work finish, and did it succeed?
  • Output location answers: where is the result now, and how long will the provider keep it there?
  • Entitlement answers: may this user, through this marketplace record, receive the output at this moment?

The workflow in order

  1. Start the job and persist its identifier. Store the provider job ID on the marketplace record (order, listing, or asset row) at the moment the provider returns it. Amazon Textract returns a job ID from its asynchronous start call. The OpenAI video API returns a job object that includes a status field. Store the operation type with the ID so a later event can be matched to the correct request.
  2. Track completion through the provider’s supported mechanism. For Textract, subscribe to completion notifications. For generated video, read the job’s status from the job endpoint. The two approaches are covered below.
  3. Process every event idempotently. Correlate the event with the stored job ID, confirm that the operation matches the one you started, and change the record’s state only if it is not already in that state.
  4. Branch on the terminal status. A success status moves the record to retrieval. A failure or error status stores the failure and never creates a download link.
  5. Retrieve or locate the output. If the product needs the file for longer than the provider keeps it, copy it into storage you control at this stage.
  6. Authorize the specific request. Evaluate entitlement on each download request, not only once when the job completes.
  7. Issue a short-lived URL or proxy the download. You choose the URL technology and its lifetime, or you stream the bytes through an authorized handler. The provider documentation does not set either.

Tracking completion without polling

The central design choice is whether your system waits for a provider event or repeatedly asks the provider whether the job is done. The two providers below are examples of how this choice looks in practice. Your pipeline does not have to use either of them.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Amazon Textract (example)

Asynchronous Textract processing supports multipage PDF and TIFF documents. Asynchronous single-page inputs can be JPEG, PNG, TIFF, or PDF. When a job finishes, Textract publishes a completion message to an Amazon SNS topic. Your application can consume that message through an Amazon SQS queue or an AWS Lambda function.

#1 Best Overall
Sale
ScanSnap iX2500 Wireless or USB High-Speed Document Scanner, Black | Cloud Enabled | Photos & Receipts | Large Touchscreen | 100 page Auto Document Feeder | Mac or PC
  • OUR MOST ADVANCED SCANSNAP. Large touchscreen, fast 45ppm double-sided scanning, 100-sheet document feeder, Wi-Fi and USB connectivity, automatic optimizations, and support for cloud services. Upgraded replacement for the discontinued iX1600
  • CUSTOMIZABLE. SHARABLE. Select personalized profiles from the touchscreen. Send to PC, Mac, mobile devices, and clouds. QUICK MENU lets you quickly scan-drag-drop to your favorite computer apps
  • STABLE WIRELESS OR USB CONNECTION. Built-in Wi-Fi 6 for the fastest and most secure scanning. Connect to smart devices or cloud services without a computer. USB-C connection also available
  • PHOTO AND DOCUMENT ORGANIZATION MADE EFFORTLESS. Easily manage, edit, and use scanned data from documents, receipts, photos, and business cards. Automatically optimize, name, and sort files
  • AVOIDS PAPER JAMS AND DAMAGE. Features a brake roller system to feed paper smoothly, a multi-feed sensor that detects pages stuck together, and skew detection to prevent paper damage and data loss

AWS advises against using the Get operations to discover completion. The official guidance reads:

“We don’t recommend getting the request completion status by repeatedly calling the Get operation.”

Rank #2
CZUR Shine Ultra Smart Portable Document Scanner, Thin Book Scanner | OCR, USB Document Camera for Desktop/Laptop, Capture Size A3, Compatible with Windows & macOS
  • Design and Speed: Work with Windows XP/7/8/10/11 AND macOS 10.13 or later. Not compatible with Android and iOS. Designed for A3&A4(11.69*16.53 & 8.27*11.75 inch) document, any objects smaller than A3 size can be scanned with Ultra-fast scanning speed, about 1 second per page. Perfect device to scan FLAT papers
  • USB Document Camera & Scanner: Work as both a document camera for remote teaching&learning compatible with ZOOM; Goole Meet and a document scanner to scan papers and convert/OCR files. OCR supports 180+ languages for text recognition. Please note that Thai, Hebrew, and Arabic are currently not supported. If you need the complete OCR language support list, please feel free to contact us for more details
  • Patented Flattening Curved Book Page Technology: Shine Ultra applies CZUR’s patented technology to flatten the curved surface after pixel transformation to flattening of the book page (Only suitable for thinner books, ET series is recommended for thicker books)
  • High Resolution & AI Tech: CMOS 13MP (4160*3120, A4≈340 AND A3≈245 DPI) camera. Smart Paging and Auto Cropping; Combine Sides; Stamp Mode; and Multiple Color Modes
  • Height Adjustable & Portable: 2-level height adjustable neck. 90 degree foldable and lightweight 4 lbs with foot pedal for convenient operation

— Amazon Web Services, Calling Amazon Textract Asynchronous Operations

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The completion message identifies the job ID, the status, the API operation, an optional job tag, a completion timestamp, and the document location. Use the job ID and operation to match the event to your record. Treat the message as a signal for backend state, not as proof that a particular user may download anything. A notification you cannot correlate to a stored request should be logged and set aside rather than acted on.

Rank #3
Sale
Brother DS-640 Compact Mobile Document Scanner, (Model: DS640)
  • FAST SPEEDS - Scans color and black and white documents a blazing speed up to 16ppm (1). Color scanning won’t slow you down as the color scan speed is the same as the black and white scan speed.
  • ULTRA COMPACT – At less than 1 foot in length and only about 1. 5lbs in weight you can fit this device virtually anywhere (a bag, a purse, even a pocket).
  • READY WHENEVER YOU ARE – The DS-640 mobile scanner is powered via an included micro USB 3. 0 cable allowing you to use it even where there is no outlet available. Plug it into you PC or laptop and you are ready to scan.
  • WORKS YOUR WAY – Use the Brother free iPrint&Scan desktop app for scanning to multiple “Scan-to” destinations like PC, Network, cloud services, Email and OCR. (2) Supports Windows, Mac and Linux and TWAIN/WIA for PC/ICA for Mac/SANE drivers. (3)
  • OPTIMIZE IMAGES AND TEXT – Automatic color detection/adjustment, image rotation (PC only), bleed through prevention/background removal, text enhancement, color drop to enhance scans. Software suite includes document management and OCR software. (4)

The status field in the notification uses three values: SUCCEEDED, FAILED, and ERROR. Only SUCCEEDED leads to result retrieval. The Amazon Textract Results Notification page lists the payload fields. After a successful event, call the matching Get operation with the job ID to read the results. The StartDocumentTextDetection reference describes that start-then-retrieve sequence.

OpenAI video generation (example)

Creating a generated video returns a job object with a status. Read that status through the job endpoint, with a polling interval and backoff that you set for your own volume. Check the status values in the current reference and branch only on the values it documents, so that a new or unfamiliar value does not accidentally unlock a download.

Rank #4
Sale
ScanSnap iX1300 Wireless or USB Double-Sided Color Document Scanner, Black
  • FITS SMALL SPACES AND STAYS OUT OF THE WAY. Innovative space-saving design to free up desk space, even when it's being used
  • SCAN DOCUMENTS, PHOTOS, CARDS, AND MORE. Handles most document types, including thick items and plastic cards. Exclusive QUICK MENU lets you quickly scan-drag-drop to your favorite computer apps
  • GREAT IMAGES EVERY TIME, NO EXPERIENCE REQUIRED. A single touch starts fast, up to 30ppm duplex scanning with automatic de-skew, color optimization, and blank page removal for outstanding results without driver setup
  • SCAN WHERE YOU WANT, WHEN YOU WANT. Connect with USB or Wi-Fi. Send to Mac, PC, mobile devices, and cloud services. Scan to Chromebook using the mobile app. Can be used without a computer
  • PHOTO AND DOCUMENT ORGANIZATION MADE EFFORTLESS. ScanSnap Home all-in-one software brings together all your favorite functions. Easily manage, edit, and use scanned data from documents, receipts, business cards, photos, and more

When the job is complete, the content endpoint returns the generated video bytes or a derived preview. Confirm which of those your code is storing, because a preview and the full asset are different files and should be recorded as such. The OpenAI Videos API reference documents job creation, status, metadata, and content retrieval.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Handle each terminal state before any link exists

  • Success. For Textract, this is SUCCEEDED. Confirm the output is present in the location you expect, then move to the authorization step.
  • Failure. For Textract, this is FAILED. Store the failure against the marketplace record, expose a retry or support path, and generate no download URL.
  • Error. For Textract, this is ERROR. Handle it like a failure for the buyer, but log it separately so that unexpected service errors can be distinguished from job-level failures in your reporting.
  • Non-success video status. Any terminal status from the video job other than success follows the same path as a failure: record it, offer a retry or support path, and create no link.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Make notification handling safe to repeat

Your handler should behave correctly if the same event arrives twice or arrives after a later event for the same job. These practices are engineering guidance for your own code. They are not a provider guarantee about delivery.

Best Value
Sale
Epson Workforce ES-400 II High-Speed Color Duplex Desktop Document Scanner | For Computers including PC and Mac with Auto Document Feeder and Image Adjustment Tools
  • FAST DOCUMENT SCANNING — Document scanner with feeder allows you to speed through stacks with a 50-sheet Auto Document Feeder (ADF); Efficient office scanner to help you scan more productively
  • INTUITIVE, HIGH-SPEED SOFTWARE — Quickly scan with this desktop document scanner; Epson ScanSmart Software lets you easily preview scans, email files, upload to the cloud, and more; Plus, automatic file naming saves even more time
  • SEAMLESS INTEGRATION — Easily incorporate your data into most document management software with the included TWAIN driver; Office document scanner integrates seamlessly with business workflows
  • EASY SHARING — Duplex scanner allows you to scan straight to email or popular cloud storage2 services like Dropbox, Evernote, Google Drive, and OneDrive for simple storage and sharing
  • SIMPLE FILE MANAGEMENT — Scanner allows the creation of searchable PDFs with Optical Character Recognition (OCR) and convert scans to editable Word or Excel files effortlessly; Designed for home and office document scanning
  • Key each state transition on the job ID plus the target state, so that a repeated event leaves the record unchanged.
  • Check the operation named in the event against the operation you started before you advance the record.
  • Acknowledge a message only after the state change is committed. If the handler crashes first, the event can be processed again rather than lost.
  • Never let a state-change handler generate or return a download URL directly. Keep URL issuance in the request path, where the entitlement check runs.

Authorize every download before issuing a URL

  1. Load the marketplace record using the job ID stored at submission, not an identifier taken from the notification body or from the client.
  2. Confirm the requesting user holds the entitlement for that record under your own policy, such as buyer, seller, or permitted staff role.
  3. Confirm the record is in the successful state and the output it points to is present.
  4. Issue the short-lived URL, or stream the bytes through your handler.

A completion notification must never serve as a public download link. Its purpose is to advance backend state. The provider references describe job status and output retrieval, not your marketplace’s permission model, so the authorization rules and URL signing approach are yours to design and test.

Retention and expiry: what each provider documents

Output availability is time-limited on both providers, but the limits are defined differently. The table shows what the cited documentation establishes.

Provider (example) Where output is held Documented expiry What your design must do
Amazon Textract Results go to an AWS-owned bucket by default. If you specify a customer S3 output bucket through OutputConfig, results are written there. Current AWS documentation describes seven days as the default retention for results held in the AWS-owned bucket. This is a Textract default, not a retention rule for OCR providers in general. If you need longer availability, or you need retention under your own policy, configure a customer S3 output location and record that location on the marketplace record.
OpenAI video generation Generated assets are retrieved through the content endpoint. The job object has an optional expires_at Unix timestamp for downloadable assets. The API reference does not specify one universal expiry duration. Read expires_at from the live job metadata, and do not promise buyers a fixed download window unless the current service terms support it.

Copying output into your own storage moves retention decisions to you, and it also moves the access-control burden. Your bucket policy and your download handler then become the controls that protect the file, so they need the same entitlement checks described above.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What the provider documentation leaves to you

  • Your marketplace’s permission model, role definitions, and rules for who may download which record.
  • The URL signing mechanism, the URL lifetime, or the choice to proxy downloads instead of issuing links.
  • How your system authenticates and validates incoming completion events beyond the AWS configuration you set up.
  • Any fixed expiry duration for generated video assets. The reference documents an optional timestamp, not a universal window.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Amazon TextractAPI designasynchronous jobsgenerated videomarketplace architectureOCRsigned URLswebhooks

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.