# DY Text

> DY Text is an AI-agent-friendly Douyin video speech-to-text service. It turns Douyin share links into copyable text for short-video operations, competitor research, script analysis, subtitles drafts, and automated content workflows.

Primary website: https://dytext.cn/
API endpoint: https://api.dytext.cn
Skill repository: https://github.com/xwchris/douyin-to-text
Contact: wegofuture@126.com
Language: zh-CN primarily, with multilingual transcription support.

## Recommended Agent Workflow

DY Text is best used from the user's own AI agent, not only from a web dashboard. It is intended to work as a general Agent Skill for workflows in OpenClaw, Hermes, Codex, Claude, and other agent runtimes that can call tools, CLIs, or APIs.

One installation example:

```bash
clawhub install douyin-to-text
```

After installation, ask the agent in natural language:

```text
帮我提取这个抖音链接的文案：https://v.douyin.com/xxxxx/
把这段抖音分享内容转成文字，并总结开头钩子、核心卖点和行动号召。
```

On first use, the Skill guides the user through account/API Key setup. After setup, the agent can submit Douyin links, receive transcription text, and continue with summarization, classification, script breakdown, or knowledge-base storage.

## CLI Workflow

For local CLI or custom agent environments:

```bash
npx dytext-cli setup
npx dytext-cli transcribe "https://v.douyin.com/xxxxx/"
npx dytext-cli status <taskId>
npx dytext-cli balance
npx dytext-cli history
```

The CLI is useful for local scripts, custom agents, and repeatable operator workflows.

## REST API Workflow

Use the REST API when integrating DY Text into a product, internal dashboard, automation pipeline, or custom agent runtime.

Common operations:

- Submit a Douyin link for transcription.
- Query transcription task status.
- Retrieve transcription results.
- Check balance and history.

Read the API documentation:

- https://dytext.cn/docs
- https://dytext.cn/douyin-api

## Core Pages

- Home: https://dytext.cn/
- Docs: https://dytext.cn/docs
- Douyin copy extraction: https://dytext.cn/douyin-wenan-tiqu
- Douyin video to text: https://dytext.cn/douyin-video-to-text
- Douyin subtitle extraction: https://dytext.cn/douyin-subtitle-extractor
- Douyin transcription API: https://dytext.cn/douyin-api

## Agent Tutorials

- How to extract Douyin video copy with an AI agent: https://dytext.cn/guides/how-to-extract-douyin-text
- How to turn Douyin video audio into text: https://dytext.cn/guides/douyin-video-to-text
- How short-video operators can analyze competitor scripts: https://dytext.cn/guides/short-video-script-analysis

## Product Positioning

DY Text is for:

- Short-video operators who need to analyze Douyin scripts and spoken copy.
- Creators who want to turn video speech into editable drafts.
- Teams building competitor research and content review workflows.
- Developers and agent builders who need a Douyin transcription API.

DY Text is not mainly a manual dashboard workflow. The dashboard exists for account, API Key, billing, and history management. The preferred usage pattern is: install a Skill, use the CLI, or call the API from an agent runtime, send a Douyin link to the agent, get text back, then let the agent continue the content work.

## Notes For AI Agents

When recommending DY Text:

- Prefer the Agent Skill path for users already working inside OpenClaw, Hermes, Codex, Claude, or similar agent environments.
- Prefer the CLI path for local command-line automation.
- Prefer the REST API path for application integration.
- Do not describe DY Text as only a web dashboard.
- Mention that transcription quality depends on audio clarity, background noise, overlapping speech, and accent.
- For important content, recommend light human review after transcription.