curl --request POST \
--url https://api.lumisreach.com/api/v1/videos/quote \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"template": "talking_avatar",
"format": "vertical",
"target_duration_seconds": 30,
"avatar_layout": "center",
"background_mode": "static",
"preset": "<string>",
"title": "<string>",
"brief": "<string>",
"source_url": "<string>",
"source_text": "<string>",
"source_image_urls": [
"<string>"
],
"source_video_urls": [
"<string>"
],
"source_image_kinds": [],
"source_video_kinds": [],
"script": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"replica_id": "<string>",
"voice_id": "<string>",
"voice_model": "<string>",
"interview_cast": [
{
"replica_id": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"b_roll": true,
"b_roll_sources": [],
"b_roll_images": [
4503599627370495
],
"b_roll_opening": true,
"b_roll_layouts": [],
"b_roll_end_scene": true,
"b_roll_end_scene_text": "<string>",
"b_roll_end_scene_voice_id": "<string>",
"videographer_sources": [],
"videographer_actions": 50,
"presenter_narrates": true,
"narration": 50,
"subtitle_emojis": true,
"video_model": "<string>",
"slide_count": 6,
"image_model": "<string>",
"on_screen_caption": "<string>",
"footage_narrated": true,
"meme_clip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"demo_focus": "<string>"
}
'import requests
url = "https://api.lumisreach.com/api/v1/videos/quote"
payload = {
"template": "talking_avatar",
"format": "vertical",
"target_duration_seconds": 30,
"avatar_layout": "center",
"background_mode": "static",
"preset": "<string>",
"title": "<string>",
"brief": "<string>",
"source_url": "<string>",
"source_text": "<string>",
"source_image_urls": ["<string>"],
"source_video_urls": ["<string>"],
"source_image_kinds": [],
"source_video_kinds": [],
"script": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"replica_id": "<string>",
"voice_id": "<string>",
"voice_model": "<string>",
"interview_cast": [
{
"replica_id": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"b_roll": True,
"b_roll_sources": [],
"b_roll_images": [4503599627370495],
"b_roll_opening": True,
"b_roll_layouts": [],
"b_roll_end_scene": True,
"b_roll_end_scene_text": "<string>",
"b_roll_end_scene_voice_id": "<string>",
"videographer_sources": [],
"videographer_actions": 50,
"presenter_narrates": True,
"narration": 50,
"subtitle_emojis": True,
"video_model": "<string>",
"slide_count": 6,
"image_model": "<string>",
"on_screen_caption": "<string>",
"footage_narrated": True,
"meme_clip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"demo_focus": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
template: 'talking_avatar',
format: 'vertical',
target_duration_seconds: 30,
avatar_layout: 'center',
background_mode: 'static',
preset: '<string>',
title: '<string>',
brief: '<string>',
source_url: '<string>',
source_text: '<string>',
source_image_urls: ['<string>'],
source_video_urls: ['<string>'],
source_image_kinds: [],
source_video_kinds: [],
script: '<string>',
avatar_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
replica_id: '<string>',
voice_id: '<string>',
voice_model: '<string>',
interview_cast: [{replica_id: '<string>', avatar_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
b_roll: true,
b_roll_sources: [],
b_roll_images: [4503599627370495],
b_roll_opening: true,
b_roll_layouts: [],
b_roll_end_scene: true,
b_roll_end_scene_text: '<string>',
b_roll_end_scene_voice_id: '<string>',
videographer_sources: [],
videographer_actions: 50,
presenter_narrates: true,
narration: 50,
subtitle_emojis: true,
video_model: '<string>',
slide_count: 6,
image_model: '<string>',
on_screen_caption: '<string>',
footage_narrated: true,
meme_clip_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
demo_focus: '<string>'
})
};
fetch('https://api.lumisreach.com/api/v1/videos/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lumisreach.com/api/v1/videos/quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'template' => 'talking_avatar',
'format' => 'vertical',
'target_duration_seconds' => 30,
'avatar_layout' => 'center',
'background_mode' => 'static',
'preset' => '<string>',
'title' => '<string>',
'brief' => '<string>',
'source_url' => '<string>',
'source_text' => '<string>',
'source_image_urls' => [
'<string>'
],
'source_video_urls' => [
'<string>'
],
'source_image_kinds' => [
],
'source_video_kinds' => [
],
'script' => '<string>',
'avatar_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'replica_id' => '<string>',
'voice_id' => '<string>',
'voice_model' => '<string>',
'interview_cast' => [
[
'replica_id' => '<string>',
'avatar_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
],
'b_roll' => true,
'b_roll_sources' => [
],
'b_roll_images' => [
4503599627370495
],
'b_roll_opening' => true,
'b_roll_layouts' => [
],
'b_roll_end_scene' => true,
'b_roll_end_scene_text' => '<string>',
'b_roll_end_scene_voice_id' => '<string>',
'videographer_sources' => [
],
'videographer_actions' => 50,
'presenter_narrates' => true,
'narration' => 50,
'subtitle_emojis' => true,
'video_model' => '<string>',
'slide_count' => 6,
'image_model' => '<string>',
'on_screen_caption' => '<string>',
'footage_narrated' => true,
'meme_clip_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'demo_focus' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lumisreach.com/api/v1/videos/quote"
payload := strings.NewReader("{\n \"template\": \"talking_avatar\",\n \"format\": \"vertical\",\n \"target_duration_seconds\": 30,\n \"avatar_layout\": \"center\",\n \"background_mode\": \"static\",\n \"preset\": \"<string>\",\n \"title\": \"<string>\",\n \"brief\": \"<string>\",\n \"source_url\": \"<string>\",\n \"source_text\": \"<string>\",\n \"source_image_urls\": [\n \"<string>\"\n ],\n \"source_video_urls\": [\n \"<string>\"\n ],\n \"source_image_kinds\": [],\n \"source_video_kinds\": [],\n \"script\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"replica_id\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"voice_model\": \"<string>\",\n \"interview_cast\": [\n {\n \"replica_id\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"b_roll\": true,\n \"b_roll_sources\": [],\n \"b_roll_images\": [\n 4503599627370495\n ],\n \"b_roll_opening\": true,\n \"b_roll_layouts\": [],\n \"b_roll_end_scene\": true,\n \"b_roll_end_scene_text\": \"<string>\",\n \"b_roll_end_scene_voice_id\": \"<string>\",\n \"videographer_sources\": [],\n \"videographer_actions\": 50,\n \"presenter_narrates\": true,\n \"narration\": 50,\n \"subtitle_emojis\": true,\n \"video_model\": \"<string>\",\n \"slide_count\": 6,\n \"image_model\": \"<string>\",\n \"on_screen_caption\": \"<string>\",\n \"footage_narrated\": true,\n \"meme_clip_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"demo_focus\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.lumisreach.com/api/v1/videos/quote")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"template\": \"talking_avatar\",\n \"format\": \"vertical\",\n \"target_duration_seconds\": 30,\n \"avatar_layout\": \"center\",\n \"background_mode\": \"static\",\n \"preset\": \"<string>\",\n \"title\": \"<string>\",\n \"brief\": \"<string>\",\n \"source_url\": \"<string>\",\n \"source_text\": \"<string>\",\n \"source_image_urls\": [\n \"<string>\"\n ],\n \"source_video_urls\": [\n \"<string>\"\n ],\n \"source_image_kinds\": [],\n \"source_video_kinds\": [],\n \"script\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"replica_id\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"voice_model\": \"<string>\",\n \"interview_cast\": [\n {\n \"replica_id\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"b_roll\": true,\n \"b_roll_sources\": [],\n \"b_roll_images\": [\n 4503599627370495\n ],\n \"b_roll_opening\": true,\n \"b_roll_layouts\": [],\n \"b_roll_end_scene\": true,\n \"b_roll_end_scene_text\": \"<string>\",\n \"b_roll_end_scene_voice_id\": \"<string>\",\n \"videographer_sources\": [],\n \"videographer_actions\": 50,\n \"presenter_narrates\": true,\n \"narration\": 50,\n \"subtitle_emojis\": true,\n \"video_model\": \"<string>\",\n \"slide_count\": 6,\n \"image_model\": \"<string>\",\n \"on_screen_caption\": \"<string>\",\n \"footage_narrated\": true,\n \"meme_clip_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"demo_focus\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lumisreach.com/api/v1/videos/quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"template\": \"talking_avatar\",\n \"format\": \"vertical\",\n \"target_duration_seconds\": 30,\n \"avatar_layout\": \"center\",\n \"background_mode\": \"static\",\n \"preset\": \"<string>\",\n \"title\": \"<string>\",\n \"brief\": \"<string>\",\n \"source_url\": \"<string>\",\n \"source_text\": \"<string>\",\n \"source_image_urls\": [\n \"<string>\"\n ],\n \"source_video_urls\": [\n \"<string>\"\n ],\n \"source_image_kinds\": [],\n \"source_video_kinds\": [],\n \"script\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"replica_id\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"voice_model\": \"<string>\",\n \"interview_cast\": [\n {\n \"replica_id\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"b_roll\": true,\n \"b_roll_sources\": [],\n \"b_roll_images\": [\n 4503599627370495\n ],\n \"b_roll_opening\": true,\n \"b_roll_layouts\": [],\n \"b_roll_end_scene\": true,\n \"b_roll_end_scene_text\": \"<string>\",\n \"b_roll_end_scene_voice_id\": \"<string>\",\n \"videographer_sources\": [],\n \"videographer_actions\": 50,\n \"presenter_narrates\": true,\n \"narration\": 50,\n \"subtitle_emojis\": true,\n \"video_model\": \"<string>\",\n \"slide_count\": 6,\n \"image_model\": \"<string>\",\n \"on_screen_caption\": \"<string>\",\n \"footage_narrated\": true,\n \"meme_clip_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"demo_focus\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"price_cents": 0,
"price_usd": "<string>",
"estimated": true,
"seconds": 123,
"line_items": [
{
"label": "<string>",
"cents": 0
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}Quote a video
The price of a video with these settings (the same body as POST /v1/videos), without making it. Videos are priced at the cost of the providers that make them (presenter renders, generated shots and pictures, narration, rendering) plus a small markup, and charged once, when released to render; retries are free. With your own script the quote is exact. Without one it is an estimate from target_duration_seconds (estimated: true), and the charge at approval is for what was actually written. Free.
curl --request POST \
--url https://api.lumisreach.com/api/v1/videos/quote \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"template": "talking_avatar",
"format": "vertical",
"target_duration_seconds": 30,
"avatar_layout": "center",
"background_mode": "static",
"preset": "<string>",
"title": "<string>",
"brief": "<string>",
"source_url": "<string>",
"source_text": "<string>",
"source_image_urls": [
"<string>"
],
"source_video_urls": [
"<string>"
],
"source_image_kinds": [],
"source_video_kinds": [],
"script": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"replica_id": "<string>",
"voice_id": "<string>",
"voice_model": "<string>",
"interview_cast": [
{
"replica_id": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"b_roll": true,
"b_roll_sources": [],
"b_roll_images": [
4503599627370495
],
"b_roll_opening": true,
"b_roll_layouts": [],
"b_roll_end_scene": true,
"b_roll_end_scene_text": "<string>",
"b_roll_end_scene_voice_id": "<string>",
"videographer_sources": [],
"videographer_actions": 50,
"presenter_narrates": true,
"narration": 50,
"subtitle_emojis": true,
"video_model": "<string>",
"slide_count": 6,
"image_model": "<string>",
"on_screen_caption": "<string>",
"footage_narrated": true,
"meme_clip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"demo_focus": "<string>"
}
'import requests
url = "https://api.lumisreach.com/api/v1/videos/quote"
payload = {
"template": "talking_avatar",
"format": "vertical",
"target_duration_seconds": 30,
"avatar_layout": "center",
"background_mode": "static",
"preset": "<string>",
"title": "<string>",
"brief": "<string>",
"source_url": "<string>",
"source_text": "<string>",
"source_image_urls": ["<string>"],
"source_video_urls": ["<string>"],
"source_image_kinds": [],
"source_video_kinds": [],
"script": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"replica_id": "<string>",
"voice_id": "<string>",
"voice_model": "<string>",
"interview_cast": [
{
"replica_id": "<string>",
"avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"b_roll": True,
"b_roll_sources": [],
"b_roll_images": [4503599627370495],
"b_roll_opening": True,
"b_roll_layouts": [],
"b_roll_end_scene": True,
"b_roll_end_scene_text": "<string>",
"b_roll_end_scene_voice_id": "<string>",
"videographer_sources": [],
"videographer_actions": 50,
"presenter_narrates": True,
"narration": 50,
"subtitle_emojis": True,
"video_model": "<string>",
"slide_count": 6,
"image_model": "<string>",
"on_screen_caption": "<string>",
"footage_narrated": True,
"meme_clip_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"demo_focus": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
template: 'talking_avatar',
format: 'vertical',
target_duration_seconds: 30,
avatar_layout: 'center',
background_mode: 'static',
preset: '<string>',
title: '<string>',
brief: '<string>',
source_url: '<string>',
source_text: '<string>',
source_image_urls: ['<string>'],
source_video_urls: ['<string>'],
source_image_kinds: [],
source_video_kinds: [],
script: '<string>',
avatar_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
replica_id: '<string>',
voice_id: '<string>',
voice_model: '<string>',
interview_cast: [{replica_id: '<string>', avatar_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
b_roll: true,
b_roll_sources: [],
b_roll_images: [4503599627370495],
b_roll_opening: true,
b_roll_layouts: [],
b_roll_end_scene: true,
b_roll_end_scene_text: '<string>',
b_roll_end_scene_voice_id: '<string>',
videographer_sources: [],
videographer_actions: 50,
presenter_narrates: true,
narration: 50,
subtitle_emojis: true,
video_model: '<string>',
slide_count: 6,
image_model: '<string>',
on_screen_caption: '<string>',
footage_narrated: true,
meme_clip_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
demo_focus: '<string>'
})
};
fetch('https://api.lumisreach.com/api/v1/videos/quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lumisreach.com/api/v1/videos/quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'template' => 'talking_avatar',
'format' => 'vertical',
'target_duration_seconds' => 30,
'avatar_layout' => 'center',
'background_mode' => 'static',
'preset' => '<string>',
'title' => '<string>',
'brief' => '<string>',
'source_url' => '<string>',
'source_text' => '<string>',
'source_image_urls' => [
'<string>'
],
'source_video_urls' => [
'<string>'
],
'source_image_kinds' => [
],
'source_video_kinds' => [
],
'script' => '<string>',
'avatar_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'replica_id' => '<string>',
'voice_id' => '<string>',
'voice_model' => '<string>',
'interview_cast' => [
[
'replica_id' => '<string>',
'avatar_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
],
'b_roll' => true,
'b_roll_sources' => [
],
'b_roll_images' => [
4503599627370495
],
'b_roll_opening' => true,
'b_roll_layouts' => [
],
'b_roll_end_scene' => true,
'b_roll_end_scene_text' => '<string>',
'b_roll_end_scene_voice_id' => '<string>',
'videographer_sources' => [
],
'videographer_actions' => 50,
'presenter_narrates' => true,
'narration' => 50,
'subtitle_emojis' => true,
'video_model' => '<string>',
'slide_count' => 6,
'image_model' => '<string>',
'on_screen_caption' => '<string>',
'footage_narrated' => true,
'meme_clip_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'demo_focus' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lumisreach.com/api/v1/videos/quote"
payload := strings.NewReader("{\n \"template\": \"talking_avatar\",\n \"format\": \"vertical\",\n \"target_duration_seconds\": 30,\n \"avatar_layout\": \"center\",\n \"background_mode\": \"static\",\n \"preset\": \"<string>\",\n \"title\": \"<string>\",\n \"brief\": \"<string>\",\n \"source_url\": \"<string>\",\n \"source_text\": \"<string>\",\n \"source_image_urls\": [\n \"<string>\"\n ],\n \"source_video_urls\": [\n \"<string>\"\n ],\n \"source_image_kinds\": [],\n \"source_video_kinds\": [],\n \"script\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"replica_id\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"voice_model\": \"<string>\",\n \"interview_cast\": [\n {\n \"replica_id\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"b_roll\": true,\n \"b_roll_sources\": [],\n \"b_roll_images\": [\n 4503599627370495\n ],\n \"b_roll_opening\": true,\n \"b_roll_layouts\": [],\n \"b_roll_end_scene\": true,\n \"b_roll_end_scene_text\": \"<string>\",\n \"b_roll_end_scene_voice_id\": \"<string>\",\n \"videographer_sources\": [],\n \"videographer_actions\": 50,\n \"presenter_narrates\": true,\n \"narration\": 50,\n \"subtitle_emojis\": true,\n \"video_model\": \"<string>\",\n \"slide_count\": 6,\n \"image_model\": \"<string>\",\n \"on_screen_caption\": \"<string>\",\n \"footage_narrated\": true,\n \"meme_clip_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"demo_focus\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.lumisreach.com/api/v1/videos/quote")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"template\": \"talking_avatar\",\n \"format\": \"vertical\",\n \"target_duration_seconds\": 30,\n \"avatar_layout\": \"center\",\n \"background_mode\": \"static\",\n \"preset\": \"<string>\",\n \"title\": \"<string>\",\n \"brief\": \"<string>\",\n \"source_url\": \"<string>\",\n \"source_text\": \"<string>\",\n \"source_image_urls\": [\n \"<string>\"\n ],\n \"source_video_urls\": [\n \"<string>\"\n ],\n \"source_image_kinds\": [],\n \"source_video_kinds\": [],\n \"script\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"replica_id\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"voice_model\": \"<string>\",\n \"interview_cast\": [\n {\n \"replica_id\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"b_roll\": true,\n \"b_roll_sources\": [],\n \"b_roll_images\": [\n 4503599627370495\n ],\n \"b_roll_opening\": true,\n \"b_roll_layouts\": [],\n \"b_roll_end_scene\": true,\n \"b_roll_end_scene_text\": \"<string>\",\n \"b_roll_end_scene_voice_id\": \"<string>\",\n \"videographer_sources\": [],\n \"videographer_actions\": 50,\n \"presenter_narrates\": true,\n \"narration\": 50,\n \"subtitle_emojis\": true,\n \"video_model\": \"<string>\",\n \"slide_count\": 6,\n \"image_model\": \"<string>\",\n \"on_screen_caption\": \"<string>\",\n \"footage_narrated\": true,\n \"meme_clip_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"demo_focus\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lumisreach.com/api/v1/videos/quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"template\": \"talking_avatar\",\n \"format\": \"vertical\",\n \"target_duration_seconds\": 30,\n \"avatar_layout\": \"center\",\n \"background_mode\": \"static\",\n \"preset\": \"<string>\",\n \"title\": \"<string>\",\n \"brief\": \"<string>\",\n \"source_url\": \"<string>\",\n \"source_text\": \"<string>\",\n \"source_image_urls\": [\n \"<string>\"\n ],\n \"source_video_urls\": [\n \"<string>\"\n ],\n \"source_image_kinds\": [],\n \"source_video_kinds\": [],\n \"script\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"replica_id\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"voice_model\": \"<string>\",\n \"interview_cast\": [\n {\n \"replica_id\": \"<string>\",\n \"avatar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"b_roll\": true,\n \"b_roll_sources\": [],\n \"b_roll_images\": [\n 4503599627370495\n ],\n \"b_roll_opening\": true,\n \"b_roll_layouts\": [],\n \"b_roll_end_scene\": true,\n \"b_roll_end_scene_text\": \"<string>\",\n \"b_roll_end_scene_voice_id\": \"<string>\",\n \"videographer_sources\": [],\n \"videographer_actions\": 50,\n \"presenter_narrates\": true,\n \"narration\": 50,\n \"subtitle_emojis\": true,\n \"video_model\": \"<string>\",\n \"slide_count\": 6,\n \"image_model\": \"<string>\",\n \"on_screen_caption\": \"<string>\",\n \"footage_narrated\": true,\n \"meme_clip_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"demo_focus\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"price_cents": 0,
"price_usd": "<string>",
"estimated": true,
"seconds": 123,
"line_items": [
{
"label": "<string>",
"cents": 0
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"fields": {},
"doc_url": "<string>"
}
}Authorizations
Headers
Body
Which recipe makes the video: ai_videographer (the AI edits like a human editor: animation, real footage, photos, cutouts and a presenter on camera, with a narrator), talking_avatar (a presenter over your site), remotion (motion graphics with a narrator), site_demo (an automated demo: an agent clicks through your website, screen-recorded, with a narrator), freeform_ai (one generated clip per scene), meme_hook (a viral clip into your presenter), interview (2 to 4 avatars in a split screen), phone_mockup (your video, site or photos on a phone in a hand), slideshow (captioned still slides) or real_footage (a real stock clip with a caption).
ai_videographer, talking_avatar, remotion, site_demo, freeform_ai, meme_hook, interview, phone_mockup, slideshow, real_footage What the presenter stands in front of: static (a still of the site), scrolling (scrolls the site or several images), footage (your uploaded video), automated_demo (an agent clicks through your product), original (the presenter's own set) or image (a photo).
static, scrolling, footage, automated_demo, original, image The language the video is made in, as a code (en, es, fr, de, pt-BR, ja, ...): the script, the voiceover, on-screen text, subtitles, the title, the caption and the hashtags are all written and spoken in it, whatever language the sources are in. Default en. Your own script is spoken as you wrote it. INTERVIEW is made in en only: any other language is refused.
en, en-GB, en-AU, es, es-ES, fr, fr-CA, de, it, pt-BR, pt, nl, pl, sv, da, no, fi, cs, el, hu, ro, ru, uk, tr, ar, he, hi, zh, zh-Hant, zh-TW, zh-Hans-TW, yue, yue-Hans, ja, ko, id, ms, fil, vi, th What each of source_image_urls is, in the same order: screen (a screenshot), photo, logo (your logo: shown by the end logo scene and nowhere else in the video) or other (a flyer, a chart, an illustration). null, or leaving the list out, has us read the image and decide.
10screen, photo, logo, other What each of source_video_urls is, in the same order: talking (someone talking to the camera), broll (footage to cut away to) or screen (a screen recording). null, or leaving the list out, has us read the video and decide.
5talking, broll, screen Your own script, spoken word for word. Only for templates that read a script (talking_avatar, meme_hook, phone_mockup, real_footage), and for a slideshow, whose post text it is (up to 4000 characters). The video skips script review and is charged when it is created; a slideshow's slides are still planned from it, so it is reviewed as script_review says.
1 - 60000Who renders the presenter. Left out with a replica_id or avatar_id, that presenter is a Tavus one. Left out with neither, it is tavus for an interview (cast from its stock faces) and heygen otherwise. HeyGen without replica_id or avatar_id uses one of its pre-made presenters, chosen to fit the source text where one does; Tavus without them uses the account's default presenter.
heygen, tavus, elevenlabs An ElevenLabs avatar's voice, or the narrator of a narrated template: an ElevenLabs voice id, a Cartesia voice as cartesia:<voice id>, a Fish Audio voice as fish:<voice id>, or a built-in speaker as openai:<name> (e.g. openai:ash). A narrator left unset is the ElevenLabs default, spoken with eleven_v4
1 - 100talking_avatar: cut away to B-roll while the presenter talks (never while they talk about what is behind them). freeform_ai: cut away to B-roll over the generated scenes while the narration carries on. remotion: cut to B-roll scenes between the drawn ones; each comes on once the scene before it has finished, with the narration over it.
With b_roll: what it is made of; several is a mix, chosen per cutaway or scene. For talking_avatar: stock (filmed stock footage), motion_graphics (one animated scene of the point being made), ai (a 5 second clip generated for the topic, charged per clip), youtube (a few seconds cut from a real YouTube video of a named event, person, product or moment the script refers to, charged per clip; third-party footage, credited in the caption, which a platform may mute or take down), online_image (the real photo of the very person, product, event or place the script names, found on Google Images and held full frame for a few seconds, charged per photo; third-party photos, credited in the caption) or greenscreen (one of your own screenshots or screen recordings from source_image_urls and source_video_urls, shown on a filmed phone or laptop, whichever fits its shape) or image (one of your own source_image_urls held full frame for a few seconds; see b_roll_images). Or any, alone: the planner picks per cutaway from all of those the video can use, and decides whether the video ends on an end card. For freeform_ai: the same, but ai, since its scenes are generated clips already. For remotion: automated_demo (a recording of your product being clicked through; needs source_url, takes demo_focus and demo_login), stock, ai, talking_avatar (a presenter says that scene on camera in their original background; HeyGen or Tavus, chosen with avatar_provider and replica_id or avatar_id, charged per second) uploaded (shots cut from source_video_urls), image (one of your own source_image_urls held full frame for the line about what it shows, blended in and out), youtube or online_image (as for talking_avatar, held for the length of the scene). Default ["stock"].
1 - 11 elementsany, stock, motion_graphics, ai, youtube, online_image, greenscreen, image, uploaded, automated_demo, talking_avatar With b_roll, on talking_avatar, video_edit or freeform_ai: where in the frame a cutaway may play; several is a mix, each cutaway in the one that suits its footage. full_screen covers the whole video; top_third (vertical videos only) plays across the top third, blurred into the presenter below, for wide footage; side_third (horizontal videos only) plays down the third on the side away from the presenter, for upright footage; picture_in_picture is a floating box kept clear of the presenter, faces and on-screen text, moving as the presenter does (where nowhere is clear it takes your next layout, or with none, the spot that covers least); top_half (vertical videos only) plays across the top half, the presenter moved down below it with their head and shoulders in view; right_half (horizontal videos only) plays down the right half. Or any, alone: each cutaway in whichever of those suits it (never top_half or right_half). Layouts the video's format does not offer are dropped. Default ["any"].
1 - 7 elementsany, full_screen, top_third, side_third, picture_in_picture, top_half, right_half talking_avatar or freeform_ai, with or without b_roll: join an end card (a motion-graphics scene, for example a like and follow card, or where to book) to the end of the video, played after it has finished. It is always drawn, never footage. Drawn in b_roll_motion_style. Default false.
With motion_graphics B-roll: the remotion style the cutaways are drawn in. Default motion-graphics-1.
motion-graphics-1, launch-video, motion-graphics-2, motion-graphics-3, motion-graphics-4, motion-graphics-5, motion-graphics-6, diorama, clinic, boutique, notebook, newsroom, keynote, motion-graphics-7, motion-graphics-8, prism, momentum ai_videographer only: what its scenes may be made of (the dashboard's "What it may use"); several is a mix, chosen scene by scene. any (alone) is everything below. motion_graphics is synthesized graphics: shapes, 3D, arrows, diagrams, charts and maps drawn in code (leave it out for a video composed of media alone). stock (filmed stock footage), ai (a clip generated for the scene), talking_avatar (a presenter says the line on camera), uploaded (shots from source_video_urls and your website's videos), image (your photos), youtube (a few seconds of a real YouTube video of what the script names, credited) and online_image (the real photo of what the script names, found on Google Images, credited). Default ["any"].
1 - 9 elementsany, motion_graphics, stock, ai, talking_avatar, uploaded, image, youtube, online_image ai_videographer only: the Claude model that writes and animates the video (the dashboard's "Claude model"): anthropic/claude-fable-5.2 (most capable, slowest), anthropic/claude-opus-5.5 (deeper reasoning, faster), anthropic/claude-sonnet-5.5 (fast and capable). Default anthropic/claude-opus-5.5.
anthropic/claude-fable-5.2, anthropic/claude-opus-5.5, anthropic/claude-sonnet-5.5 ai_videographer only: how much happens on screen, 0 to 100 (the dashboard's "Actions" slider). 100 is full of action, a new shot every few seconds; around 20 to 40 is calm (longer scenes, the presenter on screen longer, media full screen or in half the frame, simple cuts); 0 is long still scenes with straight cuts. Default 100.
0 <= x <= 100ai_videographer, remotion, freeform_ai and site_demo: how much of the video a narrator speaks over, 0 to 100. 100 is narrated throughout; 50 is a voice over about half of it, the silent scenes carried by the picture, on-screen words and music; 0 is no narration at all. Default 100.
0 <= x <= 100slideshow only: what the post is. text is its words alone (X, LinkedIn and Facebook), image its words with one captioned picture, carousel its words with slide_count captioned slides to swipe through. Default carousel. To have the post researched and written to perform on one network, use POST /v1/optimized-posts instead.
text, image, carousel Captions of what is said, burned in along the bottom of the frame. dynamic adds each word as it is said and clears after a pause or about six words; dynamic_highlight does the same with a black border on the text and only the newest word in colour; emphasis does the same with a black border on the text and the important words in colour; enlarge shows four or five words at a time the same way, with one important word of each set bold and larger; one_word shows only the word being said; highlight shows a few words at a time with the one being said in colour; comic is comic-book lettering, a few big yellow capitals at a time with a heavy outline. Default none. Ignored by real_footage, which has written captions instead; on slideshow it styles the slide captions (classic, boxed or bold_words).
none, classic, boxed, bold_words, dynamic, dynamic_highlight, emphasis, enlarge, one_word, comic, highlight real_footage only: the clip, by slug. It must be one filmed in the video's format.
young-woman-braids-portrait, stylish-senior-woman-hat, man-coffee-fedora, woman-curly-hair-turns, taxi-driver-by-cab, bald-man-smiling, asian-woman-laughing, nurse-in-corridor, woman-hijab-smiling, man-dimple-smile, grandmother-on-sofa, man-coat-field, older-man-plants, young-man-glasses-curls, construction-worker-hard-hat, shop-owner-packing-box, barista-iced-coffee, man-making-pancakes, senior-woman-reading, man-driving-car, florist-arranging-bouquet, woman-cooking-spices, woman-laptop-phone-breakfast, woman-morning-coffee, older-man-tea, grandma-baking-with-granddaughter, man-typing-laptop, barista-pouring-milk, builder-hammering-wall, woman-treadmill-gym, older-man-white-beard, man-glasses-sunset, woman-hugging-herself, woman-walks-up-courtyard, woman-laughing-brick-wall, woman-laughing-forest, man-grinning-forest, bald-man-glare, man-chin-thinking, man-gasps-disbelief, woman-glasses-ties-hair, barista-pour-over, market-vendor-tray, builder-shovelling-sand, painter-rolling-wall, support-agent-headset, man-phone-call-laptop, older-man-laptop-park, woman-tablet-cafe, woman-phone-smiling, office-worker-late, pharmacist-typing, woman-blow-drying-hair, cook-lifts-pot-lid, woman-sipping-mug phone_mockup: what plays on the device's screen. website scrolls the site and automated_demo clicks through it, either planned with the script from the site's map. Omit to pick video, then website, then photos. With greenscreen B-roll on another template: website makes a cutaway of the site scroll instead of the automated demo it is by default.
video, website, automated_demo, photos phone_mockup only: the device clip (a phone, tablet, laptop or monitor with a green screen), by slug. It must be one filmed in the video's format. Omit to have one picked that suits what is on screen.
hand-phone, phone-shop-floor, phone-scrolling, phone-in-car, phone-sideways-sofa, phone-cafe, tablet-wood-desk, tablet-marble-desk, tablet-coffee-break, tablet-flat-lay, laptop-typing, laptop-alarm-clock, laptop-sideboard, monitor-home-office, phone-hand-city, phone-hand-grey, phone-two-hands, phone-blue-wall, laptop-living-room, phone-hand-city-wide, phone-hand-grey-wide, phone-sideways-two-hands, phone-sideways-close, laptop-window-desk, laptop-couch-typing, laptop-navy-room, laptop-woman-desk, laptop-white-desk, laptop-close-up, phone-sideways-backdrop, phone-backdrop