Annotate Video
video_intelligence.annotate_video
ActionGoogle Cloudconnection required
Calls the Video Intelligence API POST /v1/videos:annotate.
Start async annotation of a gs:// video or an uploaded video file.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Google Video Intelligence
- Secret shape
- {"client_id", "client_secret", "refresh_token"}
- Config it needs
- project_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
input_uri gs://bucket/video.mp4. Leave empty to send the upstream/inline file. | string | No | — | — | — |
file_content Video as base64 (used when input_uri is empty). | string | No | — | — | — |
features Features to run, any of: LABEL_DETECTION, SHOT_CHANGE_DETECTION, EXPLICIT_CONTENT_DETECTION, SPEECH_TRANSCRIPTION, TEXT_DETECTION, OBJECT_TRACKING. | array | No | ["LABEL_DETECTION"] | array of string | — |
language_code Speech language for SPEECH_TRANSCRIPTION. | string | No | en-US | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"features": [
"LABEL_DETECTION"
],
"language_code": "en-US"
}Input
| Field | Type | Example |
|---|---|---|
file_content The file, base64-encoded. | string | — |
content_encoding | string | base64 |
filename | string | app-main.zip |
content_type | string | application/zip |
size Raw size in bytes (before base64). | number | — |
Output
One shape.
operation
| Field | Type | Example |
|---|---|---|
ok | boolean | — |
operation Operation name to pass to Get Operation. | string | — |
done | boolean | — |
{
"done": false,
"ok": false,
"operation": ""
}Notes
- The node does not poll; wire Get Operation (with a Wait) to fetch results.
Related Google Video Intelligence nodes
See Annotate Video run in a workflow.
In a technical demo we add the Google Video Intelligence connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.