Convert Speech To Text

This Endpoint creates and retrieves subtitles from any given video, providing flexibility in output formats. Choose between JSON, Adobe, or plain text formats to suit your needs.

GEThttps://api.spikes.studio/get-captions

Required Parameters

  • Name
    video_url
    Type
    string
    Description
    The URL of the video to obtain captions from.

Optional Parameters

  • Name
    json
    Type
    boolean
    Description
    Choose to get captions in JSON format.
    • Default: TRUE
  • Name
    adobe
    Type
    boolean
    Description
    Choose to get captions in Adobe format.
    • Default: FALSE
  • Name
    plain_text
    Type
    boolean
    Description
    Choose to get captions in plain text format.
    • Default: FALSE

Response

  • Name
    captions_json
    Description

    A text file with the captions

  • Name
    time_stamps
    Description

    Time stamps of the relevant captions

Request

GET
https://api.spikes.studio/get-captions
  https://api.spikes.studio/get-captions?video_url=https://example.com/video.mp4&json=true&adobe=false&plain_text=false

Response

  {
    "captions_json": "https://example.com/captions.json",
    "time_stamps": [
      {
        "start_time": "00:00:02",
        "end_time": "00:00:05",
        "caption": "This is the first caption"
      },
      {
        "start_time": "00:00:08",
        "end_time": "00:00:10",
        "caption": "This is the second caption"
      }
    ]
  }

Errors

  • Name
    400 Bad Request
    Description

    The request was malformed or missing required parameters.

  • Name
    401 Unauthorized
    Description

    The API key provided was invalid or missing.

  • Name
    404 Not Found
    Description

    The requested resource was not found.

  • Name
    500 Internal Server Error
    Description

    500 Internal Server Error

Was this page helpful?