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

Hour One videos API

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

Hour One videos API is one of 6 APIs that Hour One 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, an API reference, and API documentation.

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

Hour One 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.

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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hour-one-videos-api-openapi.yml Raw ↑

Other APIs Hour One publishes across the network.

Hour One general API
Hour One keys API
Hour One playground API
Hour One voice-preview API
Hour One webhook API