API reference

Send article via API

Create transcriptions via our API.


Creating a transcription

The transcribe api reachable via the beset/transcribe/v1/article requires 3 variables an article_uri, main_content, and headline_content. For submitting a transcription job we also require your private api key instead of your public api key.

Property nameMeaningtype
article_uriWhere this resource can be found or an artificial uri for you to be able to find and identify it.string
main_contentThe bulk of the transcription, the main article contentstring
headline_contentThe headline that will intro the main content, if an empty string it will be ignored.string

Example Request


requests.post("beset/transcribe/v1/article" ,{
  // Content url or Some unique uri for it"
  article_uri: "testpage.app/look-at-my-blog",
  headline_content: "Did you hear about this?",
  main_content: "Beset is awesome and I'm going to tell my peers about it."
}, headers={ "X-API-KEY": "YOUR_PRIVATE_SECRET_API_KEY" })
Previous
Player behavior