Files

Upload an image

Stores an image you send as the request body, with no multipart encoding: curl --data-binary @photo.jpg. PNG, JPEG or WebP, up to 4 MB; the type is read from the bytes. Pass the returned ID in a model's input. Send videos and sounds through POST /v1/uploads instead.

Needs an API key with the generations:write scope.

post/v1/files

Request

  • Base URL: https://api.tryleap.ai
  • URL: https://api.tryleap.ai/v1/files
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

filenamestring

A name to keep with the file, such as portrait.jpg.

Response

The stored file.

idstring required

The file's ID, file_.... Pass it in a model's input.

object'file' required
content_typestring required

The type, read from the file's bytes, such as image/jpeg or video/mp4.

bytesinteger required

The size in bytes.

widthinteger nullable required

Width in pixels; null for a sound.

heightinteger nullable required

Height in pixels; null for a sound.

durationnumber nullable required

A video's or a sound's length in seconds; null for an image.

filenamestring nullable required

The name you gave, if any.

urlstring uri required

A signed link to the file, valid for 24 hours. Read the file again for a fresh one.

created_atstring date-time required

When it was stored.

Changes

No recorded changes to this operation across all 1 revision of this API.