LogTalk API

Transform your changelogs into engaging audio and video content programmatically. Perfect for CI/CD integration with GitHub Actions, GitLab CI, and more.

Download OpenAPI Spec Create API Key

Base URL

All API requests should be made to the following base URL:

https://api.logtalk.io/v1

Endpoints

The LogTalk API provides the following endpoints:

Method	Endpoint	Description
`POST`	`/episodes`	Create a new episode
`GET`	`/episodes`	List all episodes
`GET`	`/episodes/{id}`	Get episode details
`DELETE`	`/episodes/{id}`	Delete a episode
`POST`	`/episodes/{id}/retry`	Retry a failed episode
`POST`	`/scripts/generate`	Generate a script for preview
`GET`	`/scripts/{id}`	Get a generated script
`GET`	`/usage`	Get usage statistics
`GET`	`/changelogs/{owner}/{repo}`	Fetch changelog from GitHub

Quick Start

Get your first audio episode in under 5 minutes:

Create an API Key

Go to Settings → API Keys to create your first API key. API access requires a Growth tier subscription or higher.

Make Your First Request

Use the cURL command below to convert a changelog to audio:

First API Request

curl -X POST https://api.logtalk.io/v1/episodes \
  -H "Authorization: Bearer lt_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "## v2.0.0 - New Features\n- Added dark mode support\n- Improved performance by 40%",
    "mode": "changelog",
    "output_format": "audio",
    "settings": {
      "product_name": "MyApp",
      "version": "2.0.0",
      "tone": "casual"
    }
  }'

Get Your Audio

Audio episodes are processed synchronously. The response includes a URL to download your audio file.

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "mode": "changelog",
    "source": "api",
    "audio_url": "https://api.logtalk.io/v1/episodes/550e8400.../audio",
    "script": "[NARRATOR]: Welcome to MyApp version 2.0...",
    "duration_seconds": 45,
    "completed_at": "2026-01-18T14:30:00.000Z",
    "created_at": "2026-01-18T14:29:30.000Z"
  },
  "request_id": "req_1kn5f2a_a3b4c5d6e7f8",
  "timestamp": "2026-01-18T14:30:00.000Z"
}

Key Features

Fast Audio Generation

Audio episodes complete in under 30 seconds. Perfect for real-time CI/CD pipelines.

Async Video ProcessingComing Soon

Video generation runs asynchronously. Poll for status or receive webhooks on completion.

Idempotent Requests

Use idempotency keys to safely retry failed requests without creating duplicates.

Webhook Notifications

Get notified instantly when episodes complete via secure webhook callbacks.

API Access Requirements

API access is available on Growth tier and above. Rate limits vary by subscription:

Tier	Daily Limit	Per-Minute	Concurrent
Growth	100 requests	20 requests	3 jobs
Pro	500 requests	60 requests	10 jobs
Team	2,000 requests	200 requests	25 jobs

Next Steps

Authentication - Learn about API key formats and security best practices
Conversions API - Full reference for creating and managing episodes
Webhooks - Set up real-time notifications for your integrations
CI/CD Examples - Ready-to-use examples for GitHub Actions, GitLab CI, and more

NextAuthentication