Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hourone videos API

The videos API from Hourone — 4 operation(s) for videos.

Hourone videos API is one of 6 APIs that Hourone publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include videos. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 6 operations across 4 paths, and defines 20 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, /api/v1.

6 operations 4 paths 20 schemas 1 DELETE3 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.makereals.com/api/v1
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Hourone videos API declares 2 security schemes for authenticating requests. An API key is passed in the header as api-key (APIKeyHeader). It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 6

Across 4 paths, the API surfaces 6 operations — 1 DELETE, 3 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

videos 6
GET
/videos
List Videos
list_videos_videos_get → 200
POST
/videos
Create Video
create_video_videos_post body → 201422
GET
/videos/{video_id}
Get Video By Id
get_video_by_id_videos__video_id__get 1 param → 200422
DELETE
/videos/{video_id}
Delete Video By Id
delete_video_by_id_videos__video_id__delete 1 param → 204422
POST
/videos/{video_id}/subtitles
Create Subtitles
create_subtitles_videos__video_id__subtitles_post 1 param body → 201422
GET
/videos/{video_id}/metadata
Get Video Metadata
get_video_metadata_videos__video_id__metadata_get 1 param → 200422

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are VideoResponse (19 properties), NewVideoRequest (12 properties), OverrideVideoRequest (12 properties), NewVideoScene (7 properties). Each schema is shown below with its type and property counts.

WorkflowVideoRequest
object
5 properties 3 required
SceneMediaAttribute
object
3 properties
NewVideoRequest
object
12 properties 5 required
NewVideoScene
object
7 properties 2 required
ValidationError
object
3 properties 3 required
SubtitlesApiRequest
object
2 properties 1 required
VideoScene
object
6 properties 1 required
VideoResponse
object
19 properties 5 required
RequestPalette
object
1 property 1 required
OverrideVideoRequest
object
12 properties 2 required
SubtitlesApiResponse
object
3 properties 2 required
SceneMetadataResponse
object
3 properties 3 required
InitiatorVideoRequest
VideoStatusEnum
string
An enumeration.
SupportedTranslationSubtitlesLanguagesCode
string
An enumeration.
SubtitlesFileExtension
string
An enumeration.
HTTPValidationError
object
1 property
VideoMetadataResponse
object
2 properties 2 required
VariableMapping
object
3 properties 1 required
SceneTextAttribute
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hourone-videos-api-openapi.yml Raw ↑

Other APIs Hourone publishes across the network.

Hourone general API
Hourone keys API
Hourone playground API
Hourone voice-preview API
Hourone webhook API