Create a captioned video
curl --request POST \
--url https://api.captioncraft.studio/v1/subtitles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"video_url": "https://your-cdn.example/video.mp4",
"preset": "highlight",
"style": {
"highlight_color": "#7651E8"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
video_url: 'https://your-cdn.example/video.mp4',
preset: 'highlight',
style: {highlight_color: '#7651E8'}
})
};
fetch('https://api.captioncraft.studio/v1/subtitles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.captioncraft.studio/v1/subtitles"
payload = {
"video_url": "https://your-cdn.example/video.mp4",
"preset": "highlight",
"style": { "highlight_color": "#7651E8" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "example_job_id",
"status": "ingesting",
"status_url": "https://api.captioncraft.studio/v1/jobs/example_job_id"
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}Captions
Create subtitles
Create a captioned video with automatic duration inspection.
POST
/
v1
/
subtitles
Create a captioned video
curl --request POST \
--url https://api.captioncraft.studio/v1/subtitles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"video_url": "https://your-cdn.example/video.mp4",
"preset": "highlight",
"style": {
"highlight_color": "#7651E8"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
video_url: 'https://your-cdn.example/video.mp4',
preset: 'highlight',
style: {highlight_color: '#7651E8'}
})
};
fetch('https://api.captioncraft.studio/v1/subtitles', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.captioncraft.studio/v1/subtitles"
payload = {
"video_url": "https://your-cdn.example/video.mp4",
"preset": "highlight",
"style": { "highlight_color": "#7651E8" }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "example_job_id",
"status": "ingesting",
"status_url": "https://api.captioncraft.studio/v1/jobs/example_job_id"
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}Requires
See Quickstart for a full submission and download example, and Media requirements for accepted sources.
subtitles:write. Submit a direct HTTPS video URL and poll the returned status_url every five seconds. Each accepted submission creates a new job, even with identical input.
Choose any of the 16 presets and optionally override typography, layout, background, outline, shadow, and applicable highlight colors through style. Omitted fields inherit the preset, including fields within nested objects. Caption styles explains all controls and preset-specific behavior.
Creating a job requires a positive prepaid balance. After inspecting the video, the API reserves its actual duration rounded up before transcription. If credit is insufficient, the job fails with
INSUFFICIENT_CREDITS. Successful jobs consume the reservation; failed and canceled jobs release it. Videos can be up to 600 seconds long.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Direct HTTPS MP4, MOV, or WebM URL. No redirects or extra auth headers. Maximum 500 MiB; must remain valid until downloaded.
Maximum string length:
4096Example:
"https://your-cdn.example/video.mp4"
Caption preset. Omitted style properties use this preset's defaults.
Available options:
classic, highlight, smash, box, push, elegant, ogre, outline, paper-ink, action, prompter, storytelling, karaoke, glow, thin&bold, background Optional lowercase two- or three-letter language code supported by transcription. Omit for automatic language detection. Does not translate.
Pattern:
^[a-z]{2,3}$Example:
"en"
Optional caption style overrides. Omitted fields (including nested fields) inherit the selected preset. Font size is derived from font_family and text_width; horizontal caption placement follows the preset. Direct font_size and horizontal_position overrides are not accepted. GET /v1/presets lists defaults, supported controls and preset-specific behavior.
Show child attributes
Show child attributes