NeriaNeria.Meridian
Videos

List video generation jobs

GET/v1/videos

Lists video generation jobs for a specific provider. Results are paginated and can be filtered using query parameters.

Query Parameters

provider*string

Provider name (e.g., "openai", "gemini")

after?string

Cursor for pagination - ID of the last item from the previous page

limit?integer

Maximum number of results to return

Default20
Range1 <= value <= 100
order?string

Sort order by creation time

Default"desc"
Value in"asc" | "desc"

Response Body

application/json

application/json

application/json

curl -X GET "http://localhost:8080/v1/videos?provider=string"
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "object": "video",
      "model": "string",
      "status": "queued",
      "progress": 0,
      "prompt": "string",
      "remixed_from_video_id": "string",
      "seconds": "string",
      "size": "string",
      "created_at": 0,
      "completed_at": 0,
      "expires_at": 0,
      "error": {
        "code": "string",
        "message": "string"
      }
    }
  ],
  "first_id": "string",
  "last_id": "string",
  "has_more": true,
  "extra_fields": {
    "request_type": "string",
    "provider": "openai",
    "model_requested": "string",
    "model_deployment": "string",
    "latency": 0,
    "chunk_index": 0,
    "raw_request": {},
    "raw_response": {},
    "cache_debug": {
      "cache_hit": true,
      "cache_id": "string",
      "hit_type": "string",
      "requested_provider": "string",
      "requested_model": "string",
      "provider_used": "string",
      "model_used": "string",
      "input_tokens": 0,
      "threshold": 0,
      "similarity": 0
    }
  }
}
{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}
{
  "event_id": "string",
  "type": "string",
  "is_bifrost_error": true,
  "status_code": 0,
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "event_id": "string"
  },
  "extra_fields": {
    "provider": "openai",
    "model_requested": "string",
    "request_type": "string"
  }
}

Generate a video POST

Creates a video generation job from a text prompt. This is an asynchronous operation that returns immediately with a job ID. Use the retrieve endpoint to check the status and get the video URL when generation is complete.

Remix a video POST

Creates a new video generation job by remixing an existing video with a new prompt. The source video must have a status of "completed" to be remixed. Returns a new video generation job that can be polled for completion.