uploads

Create an upload session

Creates a chunked upload session for files larger than the single-shot /v1/files cap. Sessions expire 1 hour after creation.

post/v1/uploads

Request

  • Base URL: https://api.aiand.com
  • URL: https://api.aiand.com/v1/uploads
  • Auth: HTTP bearer

Request body

filenamestring required
purpose'vision' | 'video' | 'audio' | 'document' required
bytesinteger required

Declared total size in bytes; checked against purpose limits

mime_typestring required

Mime type; checked against purpose allowlist

Response

The upload session in pending status

idstring required

Stable upload session id with upload- prefix

object'upload' required
bytesinteger required

Declared total size of the file being uploaded

created_atinteger required

Unix timestamp

expires_atinteger required

Unix timestamp (1 hour from creation by default)

filenamestring nullable required
purpose'vision' | 'video' | 'audio' | 'document' required
status'pending' | 'completed' | 'cancelled' | 'expired' | 'failed' required

Changes

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