AIaituber
Clips

Get a clip by ID

Changed on

Returns a clip with its generation status. Poll every 10-15 seconds after POST /clips until status is completed (then download from outputUrl) or failed (see errorMessage; credits are refunded automatically).

get/clips/{id}

Request

  • Base URL
    https://app.aituber.app/api/v1
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Clip ID from POST /clips.

Response

OK

idstring uuid required

Clip ID.

titlestring required

Clip title.

statusstring required

Generation status: pending, processing, completed, or failed.

modelKeystring required

The model used.

aspectRatiostring required

Clip aspect ratio.

resolutionstring nullable required

Output resolution.

durationnumber nullable required

Clip length in seconds.

promptstring required

The text prompt used, if any.

outputUrlstring nullable required

Download URL for the finished MP4 clip. null until status is completed.

errorMessagestring nullable required

Why generation failed, when status is failed.

createdAtstring date-time required

When the clip was created (ISO 8601).

Changes