seadanceai-transcript-sdk (Python)
Community-maintained Python toolkit for retrieving YouTube transcripts, checking available languages, exporting TXT/SRT/VTT files, and generating heuristic summaries. Proudly sponsored by Seedance AI.
✨ Features
- Dual-source transcripts: tactiq endpoint first, fallback to
youtube-transcript-apifor reliability. - Language probing: batch-check common caption languages.
- Formatters: output transcripts as TXT/SRT/VTT with helper functions.
- Summary helpers: generate concise recaps + key points without external APIs.
- Zero external API keys required; just Python + HTTP.
📦 Installation
pip install seadanceai-transcript-sdk
⚡ Quick Start
from seadance_transcript_sdk import TranscriptClient, format_transcript_file
client = TranscriptClient(enable_fallback=True)
transcript = client.get_transcript("dQw4w9WgXcQ", language="en")
file_payload = format_transcript_file(transcript, fmt="srt")
with open(file_payload.filename, "w", encoding="utf-8") as fh:
fh.write(file_payload.content)
More helpers:
from seadance_transcript_sdk import detect_available_languages
langs = detect_available_languages("dQw4w9WgXcQ")
print([lang.name for lang in langs.languages])
summary = client.summarize(transcript)
print(summary.summary)
🧩 Modules
seadance_transcript_sdk.transcript– fetch logic + language probing.seadance_transcript_sdk.formatting– TXT/SRT/VTT helpers.seadance_transcript_sdk.summary– heuristic summary utilities.seadance_transcript_sdk.client– ergonomic wrapper with sensible defaults.
🤝 Contributing
python -m venv .venv && source .venv/bin/activatepython -m pip install -e ".[dev]"pytest && python -m build
🙌 Sponsorship
Development is powered by Seedance AI.
Release process
Releases are built and published from GitHub Actions through PyPI Trusted Publishing. Maintainers bump the version and push the matching tag:
VERSION=$(python -c 'import pathlib, tomllib; print(tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"])')
git tag "v${VERSION}"
git push origin "v${VERSION}"
📄 License
MIT © Seadance AI & contributors.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file seadanceai_transcript_sdk-0.1.2.tar.gz.
File metadata
- Download URL: seadanceai_transcript_sdk-0.1.2.tar.gz
- Upload date:
- Size: 11.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a12190602dbc3deb9240271ed7f5050d23bde144a0079d5f92277ef5d5ceec28
|
|
| MD5 |
f401511c375355c0eda50e94ff0dc01d
|
|
| BLAKE2b-256 |
3cfcf5839bc9566f08d2880219f06314e9e861bb1d744ba7a64519623de7c703
|
Provenance
The following attestation bundles were made for seadanceai_transcript_sdk-0.1.2.tar.gz:
Publisher:
release.yml on SeaVid-AI/yyt-transcript-sdk-py
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
seadanceai_transcript_sdk-0.1.2.tar.gz -
Subject digest:
a12190602dbc3deb9240271ed7f5050d23bde144a0079d5f92277ef5d5ceec28 - Sigstore transparency entry: 2194444361
- Sigstore integration time:
-
Permalink:
SeaVid-AI/yyt-transcript-sdk-py@bdc15bd8d88c51bc914ce4887bbd656e082c5be5 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/SeaVid-AI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bdc15bd8d88c51bc914ce4887bbd656e082c5be5 -
Trigger Event:
push
-
Statement type:
File details
Details for the file seadanceai_transcript_sdk-0.1.2-py3-none-any.whl.
File metadata
- Download URL: seadanceai_transcript_sdk-0.1.2-py3-none-any.whl
- Upload date:
- Size: 11.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6e90f9dd645475d00cf5b83b0f724e28956ddfc0b1b59e3b6a0225d6586f93a9
|
|
| MD5 |
144d0b8ce7ac18e9d1436d8bc10f48aa
|
|
| BLAKE2b-256 |
0102e33083ffdc39c81dc999b03ad8c438af8951d3d563a4d7b0b1c6b93f4357
|
Provenance
The following attestation bundles were made for seadanceai_transcript_sdk-0.1.2-py3-none-any.whl:
Publisher:
release.yml on SeaVid-AI/yyt-transcript-sdk-py
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
seadanceai_transcript_sdk-0.1.2-py3-none-any.whl -
Subject digest:
6e90f9dd645475d00cf5b83b0f724e28956ddfc0b1b59e3b6a0225d6586f93a9 - Sigstore transparency entry: 2194444368
- Sigstore integration time:
-
Permalink:
SeaVid-AI/yyt-transcript-sdk-py@bdc15bd8d88c51bc914ce4887bbd656e082c5be5 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/SeaVid-AI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bdc15bd8d88c51bc914ce4887bbd656e082c5be5 -
Trigger Event:
push
-
Statement type: