Postman Collection
API Reference

Create Caption

post
https://api.3playmedia.com/v3/captions

Order captions on one media file in a single call: upload, URL, or an existing media file, plus the order. Captions are in the media's source language, so the one orders[] entry takes no target_language. Packages: launch, refine, accommodate, studio. Turnarounds: standard, asap, flexible. Not every service offers every package or turnaround; List Products shows what your project can order.

The whole request is validated first. If any order is unavailable (package, turnaround, or language pairing), the call returns 400 with the allowed values and nothing is created.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
file

Media file to upload, sent as multipart form data. Supply exactly one of source, source_url, or media_file_id

string

URL 3Play downloads the media from before processing. Authenticated URLs need at least 1 day of validity. Supply exactly one of source, source_url, or media_file_id

integer

ID of a media file already in 3Play to reuse. Supply exactly one of source, source_url, or media_file_id

string
required

Name of the media file

string

Description of the media file

string
required

Language code of the media (browser navigator code). Accepts a generic (en) or regional (en-US) code; a generic code resolves to the project's default variant

string

Your own key for the media, echoed on each order and in callbacks

string

Folder to file the media under

string

URL 3Play POSTs to once per order when it reaches a terminal status, retried if delivery fails

string

Free-text instructions that apply to the whole order

orders
array of objects
required

Exactly one entry. Captions are in the media's language, so the entry takes no target_language

orders*
Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

401

Unauthorized

Callback

Updated about 4 hours ago

Did this page help you?
Language
Credentials
Query
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 4 hours ago

Did this page help you?