---
title: "Create / look up a visual analysis task for a video"
method: POST
path: "/v1/video/visuals"
tags: ["agent", "video"]
---

# Create / look up a visual analysis task for a video

`POST /v1/video/visuals`

## Request body

- object
  - `videoUrl` string, uri, required
  - `speed` number
  - `model` string
  - `force` boolean
  - `language` string

## Response `200`

Successful response

- object
  - `taskId` string, required
  - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'superseded', required
  - `isFromCache` boolean

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.net/bibigpt/apis/bibigpt-openapi.md) · [All operations](https://skmtc.net/bibigpt/apis/bibigpt-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bibigpt/bibigpt-openapi/versions/6923ed89c442/schema)