Render take video

curl --request POST \
  --url https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "show_ai_label": true,
  "show_logo": true
}
'

import requests

url = "https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render"

payload = {
    "show_ai_label": True,
    "show_logo": True
}
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({show_ai_label: true, show_logo: true})
};

fetch('https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render', 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://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render",
  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([
    'show_ai_label' => true,
    'show_logo' => true
  ]),
  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://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render"

	payload := strings.NewReader("{\n  \"show_ai_label\": true,\n  \"show_logo\": true\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://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"show_ai_label\": true,\n  \"show_logo\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render")

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  \"show_ai_label\": true,\n  \"show_logo\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "22222222-3333-4444-5555-666666666666",
  "clip_id": "11111111-2222-3333-4444-555555555555",
  "name": "Take 1",
  "status": "starting_video",
  "avatar_id": "66666666-7777-8888-9999-000000000000",
  "error": null,
  "audio_url": "https://example.s3.amazonaws.com/audio?X-Amz-Expires=3600",
  "video_url": null,
  "created_at": "2026-08-25T20:00:00+00:00",
  "updated_at": "2026-08-25T20:00:12+00:00",
  "text": "Welcome to Acme. Thanks for watching.",
  "phonemes": "wˈɛlkəm tə ˈækmi",
  "chunk_prompts": [
    {
      "index": 0,
      "start": 0,
      "end": 2.92,
      "text": "Welcome to Acme.",
      "face_prompt": "A lady is talking with animated facial expressions, frequently raising and arching the eyebrows for emphasis. Only the foreground is moving, the background remains static.",
      "upper_body_prompt": "A lady is talking to the camera with natural movements while speaking. The torso and shoulders stay steady. Only the foreground person is moving, the background remains static."
    }
  ],
  "show_ai_label": true,
  "show_logo": true,
  "estimated_seconds": 210,
  "credits_charged": 4,
  "credits_used": 4.25,
  "credits_remaining": 20.75
}

POST

clips

{clip_id}

takes

{take_id}

render

Render take video

curl --request POST \
  --url https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "show_ai_label": true,
  "show_logo": true
}
'

import requests

url = "https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render"

payload = {
    "show_ai_label": True,
    "show_logo": True
}
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({show_ai_label: true, show_logo: true})
};

fetch('https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render', 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://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render",
  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([
    'show_ai_label' => true,
    'show_logo' => true
  ]),
  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://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render"

	payload := strings.NewReader("{\n  \"show_ai_label\": true,\n  \"show_logo\": true\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://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"show_ai_label\": true,\n  \"show_logo\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://akapulu.com/api/clips/{clip_id}/takes/{take_id}/render")

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  \"show_ai_label\": true,\n  \"show_logo\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "22222222-3333-4444-5555-666666666666",
  "clip_id": "11111111-2222-3333-4444-555555555555",
  "name": "Take 1",
  "status": "starting_video",
  "avatar_id": "66666666-7777-8888-9999-000000000000",
  "error": null,
  "audio_url": "https://example.s3.amazonaws.com/audio?X-Amz-Expires=3600",
  "video_url": null,
  "created_at": "2026-08-25T20:00:00+00:00",
  "updated_at": "2026-08-25T20:00:12+00:00",
  "text": "Welcome to Acme. Thanks for watching.",
  "phonemes": "wˈɛlkəm tə ˈækmi",
  "chunk_prompts": [
    {
      "index": 0,
      "start": 0,
      "end": 2.92,
      "text": "Welcome to Acme.",
      "face_prompt": "A lady is talking with animated facial expressions, frequently raising and arching the eyebrows for emphasis. Only the foreground is moving, the background remains static.",
      "upper_body_prompt": "A lady is talking to the camera with natural movements while speaking. The torso and shoulders stay steady. Only the foreground person is moving, the background remains static."
    }
  ],
  "show_ai_label": true,
  "show_logo": true,
  "estimated_seconds": 210,
  "credits_charged": 4,
  "credits_used": 4.25,
  "credits_remaining": 20.75
}

Start talking-avatar video for a take that is ready_to_render with audio_url set. This locks phonemes and video instructions. Credits are charged when the job starts. If there are not enough credits, the request fails and the take is unchanged. Optional body (both default true):

show_ai_label — overlay This is AI. Can be false on any plan.
show_logo — overlay Made by plus the Akapulu Labs logo. false requires Starter or higher.

Recommend leaving show_ai_label on. Invisible watermarks and Content Credentials still go on the files. Details: AI content disclosure. Poll Get take until status is complete, then download video_url.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

clip_id

string<uuid>

required

Clip ID.

take_id

string<uuid>

required

Take ID.

Body

application/json

show_ai_label

boolean

default:true

Overlay This is AI. Allowed false on every plan.

show_logo

boolean

default:true

Overlay Made by plus the Akapulu Labs logo. false requires Starter or higher.

Response

Video job started

string<uuid>

required

clip_id

string<uuid>

required

name

string

required

status

enum<string>

required

Current landmark. Poll until ready_to_render for audio, complete for video.

Available options:

starting_tts,

generating_audio,

generating_motion_instructions,

ready_to_render,

starting_video,

preparing_video,

generating_face_video,

generating_avatar_gestures,

compositing,

applying_labels,

watermarking,

signing,

complete,

failed

avatar_id

string<uuid>

required

error

string | null

required

audio_url

string | null

required

Hour-long download URL once audio exists.

video_url

string | null

required

Hour-long download URL once video exists.

created_at

string<date-time>

required

updated_at

string<date-time>

required

text

string

phonemes

string

chunk_prompts

object[]

Show child attributes

show_ai_label

boolean

show_logo

boolean

estimated_seconds

number

Approximate seconds left in the current job.

credits_charged

any

Credits charged for this request, when a job was billed.

credits_used

any

credits_remaining

any

Overview

Starting a conversation

Transcripts and recordings

Scenarios

Endpoints

Knowledge bases

Clips

Takes

Render take video

Authorizations

Path Parameters

Body

Response