Create a new audio article

Create a new audio article within a specific project.

post
Post a new audio article

https://app.speechkit.io/api/v3/projects/{project_id}/audio
This endpoint allows you to add new audio articles to your project. All requests must include a Content-Type header of application/json.
Request
Response
Request
Path Parameters
project_id
required
integer
ID of the project you wish to add audio to
Body Parameters
metadata
optional
object
Any custom data related to the audio article
external_id
optional
string
Your own internal ID
body
required
string
Text content of your article (max 100000 chars)
title
optional
string
Title for the audio edition
author
optional
string
Author of the article
article_url
optional
string
Web page (URL) where the article is located
api_key
required
string
Your API key
Response
200: OK
Audio successfully created within the project.
{
"id": 999,
"external_id": "123-a",
"state": "unprocessed",
"media": [
{
"id": 999,
"content_type": "mp3",
"url": []
}
],
"deleted": false,
"metadata" :{
"key": string
}
}
400: Bad Request
Invalid request.
401: Unauthorized
Invalid API key.
404: Not Found
Wrong project ID.

If you are using the API to both create and retrieve your audio, we advise including a unique external_id with your request that relates to the content, so you can easily retrieve the audio when necessary using this same ID.

For example requests, responses and to test your API calls, check out our API Explorer.