Uploads
Turns a local file into an upload id you can pass to /images/ or
/videos/. Use this when the file is not already on a public https URL.
Accepted formats and limits are listed under Media inputs on the overview.
Upload a file
Stores one file and returns an upload id. Pass that id to /images/ in
uploads, or to /videos/ positionally as image1, video1, audio1
and so on.
The id is single-use and expires about 20 minutes after upload. Once a
request claims it, even a request that is then rejected, a later
reference fails: with invalid_upload on /images/ and with
invalid_request on /videos/.
Limits and accepted formats are listed under Media inputs on the overview. Rate limited to 10,000 uploads per 24 hours.
Upload a file › Responses
Stored.
idPass this to a generation endpoint.
original_filenameThe filename you sent, echoed back.
urlSigned, short-lived link to the stored file, for previewing it. Pass id, not this URL, to a generation.
created_at