GET/v1/videos

List videos

Your video jobs, newest first by default.

Authentication: Bearer API key in the Authorization header

Query parameters

  • limitinteger

    Page size from 1 to 100.

    Default: 20
  • afterstring

    Return jobs after this video id.

  • orderenum

    Sort by creation time.

    "asc""desc"
    Default: "desc"

Responses

  • 200

    A page of jobs.

    Response
    • objectstring
    • dataarray<object>
      data
      • idstring
      • objectstring
      • modelstring
      • statusenum
        "queued""in_progress""completed""failed"
      • progressinteger

        0 to 100.

      • created_atinteger
      • completed_atinteger | null
      • expires_atinteger | null

        When the stored video expires.

      • secondsstring
      • sizestring
      • errorobject | null

        {code, message} when the job failed.

      • remixed_from_video_idnull
    • first_idstring | null
    • last_idstring | null
    • has_moreboolean
  • 401

    The key is missing, malformed, expired or revoked.

    Response
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"

Request

curl https://api.experientiallabs.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910",
      "object": "video",
      "model": "veo-3.1-generate-preview",
      "status": "completed",
      "progress": 100,
      "created_at": 1795132800,
      "completed_at": 1795132894,
      "expires_at": 1795219294,
      "seconds": "8",
      "size": "1280x720",
      "error": null,
      "remixed_from_video_id": null
    }
  ],
  "first_id": "video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910",
  "last_id": "video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910",
  "has_more": false
}

https://api.experientiallabs.ai/v1/videos