Agent skill

Iflytek Video Translate

by iflytek in iflytek/iFly-Skills

A skill your agent uses when user asks to translate videos, dub video content, or localize videos into other languages.

Apache-2.0Auto-check passedWriting & Content

Install Iflytek Video Translate

skills CLI
$ npx skills add iflytek/iFly-Skills --skill iflytek-video-translate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install iflytek/iFly-Skills iflytek-video-translate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/iflytek/iFly-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/iflytek-video-translate .claude/skills/iflytek-video-translate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
iflytek-video-translate
GitHub stars
209
Token cost
~1.7k tokens
SKILL.md length
497 words
Files
4 (incl. scripts)
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when user asks to translate videos, dub video content, or localize videos into other languages.

  • Works in 2 steps: Install Dependency → Configure Environment Variables
  • User asks to translate videos
  • SKILL.md covers API Endpoints, Features, Usage Scenarios and Setup, plus 7 more sections
  • Runs Python scripts from its folder; calls python3 and pip; reaches spark-api-test.xf-yun.com; needs IFLY_API_KEY and IFLY_API_SECRET

What it does

Iflytek Video Translate is an agent skill from iflytek/iFly-Skills. Use when user asks to translate videos, dub video content, or localize videos into other languages. Translate videos with AI-powered dubbing using iFlytek (Xfei) Video Translation API. Supports video language translation, voice dubbing, multilingual video localization, 视频翻译, 视频配音, 视频本地化. Features task creation, task list, task details retrieval. Ideal for content creators and localization teams.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `README.md`, `_meta.json` and `scripts/xfei_video_translate.py`).

It sits in Writing & Content, covering Translation, Text to speech and voice and Internationalization. The repository describes itself as: Official collection of iFLYTEK skills for speech, OCR, translation, proofreading, and multimodal AI capabilities. The licence is Apache-2.0.

When your agent uses it

  • User asks to translate videos
  • Dub video content
  • Localize videos into other languages

Example prompts

  • “/iflytek-video-translate”

Requirements

  • Python 3
  • A credential in IFLY_API_KEY
  • A credential in IFLY_API_SECRET

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Install Dependency
  2. Configure Environment Variables

What it can do on your machine

Read from SKILL.md and the folder at commit 08cb03f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • spark-api-test.xf-yun.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • IFLY_API_KEY
    • IFLY_API_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Iflytek Video Translate loads about 1.7k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from iflytek/iFly-Skills at commit 08cb03f, republished under its Apache-2.0 licence (© iflytek). 497 words, ~1,742 tokens.

Download SKILL.mdSave it as .claude/skills/iflytek-video-translate/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
iflytek-video-translate
description
Use when user asks to translate videos, dub video content, or localize videos into other languages. Translate videos with AI-powered dubbing using iFlytek (Xfei) Video Translation API. Supports video language translation, voice dubbing, multilingual video localization, 视频翻译, 视频配音, 视频本地化. Features task creation, task list, task details retrieval. Ideal for content creators and localization teams.
metadata.homepage
https://www.xfyun.cn/doc/Develop/Video_Translation
metadata.openclaw
{"emoji":"🎬","requires":{"bins":["python3"],"env":["IFLY_API_KEY","IFLY_API_SECRET"]},"primaryEnv":"IFLY_API_KEY"}

Xfei Video Translation

Translate videos with AI-powered dubbing using iFlytek's Video Translation service.

API Endpoints

Base URL: https://spark-api-test.xf-yun.com/api/v1/video-translate

EndpointMethodDescription
/tasksPOSTCreate video translation task
/tasksGETList all tasks
/tasks/:taskIdGETGet task details

Features

  • Video Translation: Translate video audio to different languages
  • AI Dubbing: Generate natural-sounding voiceovers
  • Multi-language: Support for English, Chinese, Japanese, Korean, etc.
  • Task Management: Create tasks, list tasks, get task details
  • Lip Sync: Automatic face matching for translated audio

Usage Scenarios

Scenario 1: Create Video Translation Task

Submit a video for translation.

Use this when: User provides a video URL and wants to translate it.

bash
# Create task - translate English video to Chinese
python3 scripts/xfei_video_translate.py --action create_task \
    --file_url "https://example.com/video.mp4" \
    --src_lang en --dest_lang zh

# Translate Chinese to English
python3 scripts/xfei_video_translate.py --action create_task \
    --file_url "https://example.com/video.mp4" \
    --src_lang zh --dest_lang en

# Translate Japanese to Chinese
python3 scripts/xfei_video_translate.py --action create_task \
    --file_url "https://example.com/video.mp4" \
    --src_lang ja --dest_lang zh
Scenario 2: List All Tasks

View all video translation tasks.

Use this when: User wants to see all translation tasks.

bash
# List all tasks
python3 scripts/xfei_video_translate.py --action list_tasks
Scenario 3: Get Task Details

View detailed information about a specific task.

Use this when: User wants to check the status and details of a specific task.

bash
# Get task details
python3 scripts/xfei_video_translate.py --action get_task \
    --task_id "xxx-xxx-xxx"

Setup

1. Install Dependency
bash
pip install requests>=2.31.0
2. Configure Environment Variables
bash
export IFLY_API_KEY="your_api_key"
export IFLY_API_SECRET="your_api_secret"

兼容说明:设置任意 IFLY_* 凭证变量(包括空值)后,仅使用该组,缺项报错;未设置标准组时,依次尝试 XFYUN_*、XFEI_*,不跨组拼接。旧前缀会在 stderr 输出一次不含凭证值的迁移提示。

Parameters

create_task (POST /tasks)
ParameterTypeRequiredDescription
--file_url / -ustringYesVideo file OSS URL (视频文件 OSS 地址)
--src_lang / -fstringYesSource language code (e.g., en, zh, ja, ko)
--dest_lang / -tstringYesTarget language code
list_tasks (GET /tasks)

No parameters required.

get_task (GET /tasks/:taskId)
ParameterTypeRequiredDescription
--task_id / -istringYesTask ID

Response Format

Standard response: {"code": 0, "message": "success", "request_id": "xxx", "data": {}}

create_task Response (data)
json
{
  "task_id": "xxx-xxx-xxx",
  "status": "waiting_parsing",
  "created_at": "2025-01-17T10:30:45Z"
}
list_tasks Response (data)
json
[
  {
    "task_id": "xxx-xxx-xxx",
    "task_name": "我的翻译任务",
    "status": "completed",
    "src_lang": "en",
    "dest_lang": "zh",
    "created_at": "2025-01-17T10:30:45Z",
    "updated_at": "2025-01-17T11:30:45Z"
  }
]
get_task Response (data)
json
{
  "task_id": "xxx-xxx-xxx",
  "task_name": "我的翻译任务",
  "status": "completed",
  "created_at": "2025-01-17T10:30:45Z",
  "updated_at": "2025-01-17T11:30:45Z",
  "task_params": {
    "file_url": "https://example.com/video.mp4",
    "src_lang": "en",
    "dest_lang": "zh"
  },
  "output": {
    "subtitle_url": "https://example.com/output.srt",
    "output_video_url": "https://example.com/output.mp4"
  }
}

Task Status Values

StatusDescription
runningTask in progress
completedTask completed successfully
failedTask failed
cancelledTask cancelled
waiting_manual_intervention_segmentWaiting for transcript editing
waiting_manual_intervention_refineWaiting for translation editing

Language Codes

CodeLanguage
zhChinese (中文)
enEnglish (英文)
jaJapanese (日文)
koKorean (韩文)
ruRussian (俄文)
frFrench (法文)
arArabic (阿拉伯语)
esSpanish (西班牙语)
yueCantonese (粤语)
Show full SKILL.md (197 more words)Show less

Input Video Requirements

  • Format: MP4
  • Duration: Max 5 minutes
  • Resolution: 720p - 4k
  • FPS: Recommended 25
  • Audio: Single audio track only

Error Handling

ErrorCauseSolution
IFLY_API_KEY and IFLY_API_SECRET are requiredNo credentials configuredSet environment variables
--file_url is requiredNo video URL providedProvide valid OSS video URL
--task_id is requiredNo task ID providedProvide valid task ID
API error XXXXRequest failedCheck message in response
鉴权失败错误提示 (๑•̀ㅂ•́)و✧

哎呀呀~遇到鉴权错误啦! (⊙_⊙) 快来看看是哪里出问题了吧~

HTTP Code错误描述原因处理建议
401{"message":"Unauthorized"}缺少 authorization 参数哎呀~检查一下有没有正确带上传入的 authorization 参数哦~
401{"message":"HMAC signature cannot be verified"}签名参数解析失败嗯嗯~ (°∀°)ノ 检查一下各签名参数是否完整,确认 APIKey 是不是正确呀~
401{"message":"HMAC signature does not match"}签名校验失败嘿呀~ (。•́︿•̀。) 检查一下 APIKey/APISecret 是否正确呢~还要看看 host、date、request-line 拼接对不对哦~signature 的 Base64 长度正常应该是 44 字节呢~
403{"message":"HMAC signature cannot be verified, a valid date or x-date header is required"}时钟偏移校验失败嗯嗯? (⊙_⊙) 服务器时钟可能有偏差哦~偏差超过 300 秒就会被拒绝啦!快去校准一下时间吧~

小贴士 💡:

  • 如果遇到签名不匹配的错误,首先检查 APIKey 和 APISecret 是否正确~
  • 确保服务器的日期时间准确,偏差太大会导致 403 错误哦~
  • 签名中的 path 需要和实际请求的路径完全一致才可以呢~

Tips

  1. Video URL: Must be an OSS (Aliyun Object Storage Service) URL accessible by iFlytek
  2. Task status: Use get_task to check task progress
  3. Completed tasks: When status is "completed", the output_video_url contains the translated video
  4. Manual intervention: Some videos may require human review for transcript or translation

© iflytek, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in skills/iflytek-video-translate of iflytek/iFly-Skills.

  • SKILL.md
  • README.md
  • _meta.json
  • scripts/xfei_video_translate.py

Open the folder on GitHubat commit 08cb03f

Compare with similar skills

Iflytek Video Translate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Iflytek Video Translate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Iflytek Video Translate this skilliflytek/iFly-Skills209—~1.7kAutomated safety check: PassApache-2.0
Video TranslatorInsiderX-Pro/video-translator928—~635Automated safety check: PassMIT
Wjs Localizing Videojianshuo/claude-skills131—~2.2kAutomated safety check: PassMIT
Translation Diff ExportDevolutions/UniGetUI26k—~1.1kAutomated safety check: PassMIT
Translation Diff ImportDevolutions/UniGetUI26k—~750Automated safety check: PassMIT
Translation Diff TranslateDevolutions/UniGetUI26k—~934Automated safety check: PassMIT

Similar skills

  • Video Translator

    InsiderX-Pro/video-translator

    Real time video translation / dubbing skill. An agent skill from InsiderX-Pro/video-translator.

    928 GitHub stars~635 tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Wjs Localizing Video

    jianshuo/claude-skills

    Thin orchestrator for the end-to-end video localization pipeline.

    131 GitHub stars~2.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Translation Diff Export

    Devolutions/UniGetUI

    Compares UniGetUI JSON locale files against English, identifies untranslated or source-changed keys, and generates patch, reference, and handoff files for a target language.

    26k GitHub stars~1.1k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translation Diff Import

    Devolutions/UniGetUI

    Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result.

    26k GitHub stars~750 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translation Diff Translate

    Devolutions/UniGetUI

    Translates a sparse UniGetUI JSON language patch, writes completed entries into the working copy, preserves placeholders and terminology, and prepares the patch for merge-back.

    26k GitHub stars~934 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Plane UI Translation

    makeplane/plane

    Sets the rules for translating and updating Plane's UI strings across locales: do-not-translate terms, plural forms, placeholders and AI translation review.

    61k GitHub stars~16k tokensUpdated yesterday
    Writing & ContentAuto-check passed

More from iflytek/iFly-Skills

All 11 skills in this repo
  • Animated Sketch Diagram

    iflytek/iFly-Skills

    生成"黑墨手绘涂鸦"风格的动画架构图/流程图:米色纸面、针管笔墨线、极淡水洗色块、简笔涂鸦图标、序号章、连线上的流动圆点动画、图标微动效。产出单文件自包含动画 HTML(SVG+CSS),可一键导出无缝循环 GIF。当用户想画架构图、流程图、信息图、技术示意图、对比图、pipeline/workflow 可视化,或提到"手绘风""涂鸦风""动图""animated diagram""GIF…

    209 GitHub stars~999 tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when user asks to review contracts, detect contract risks, or perform compliance checks.

    209 GitHub stars~773 tokensUpdated yesterday
    Auto-check passed
  • Iflytek Hyper Tts

    iflytek/iFly-Skills

    A skill your agent uses when user asks to synthesize speech, convert text to audio, or read text aloud.

    209 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Iflytek Image Understanding

    iflytek/iFly-Skills

    A skill your agent uses when user asks to analyze an image, describe image contents, or answer questions about a picture.

    209 GitHub stars~949 tokensUpdated yesterday
    Auto-check passed
  • Iflytek OCR Invoice

    iflytek/iFly-Skills

    A skill your agent uses when user asks to recognize invoices, extract receipt data, or OCR bills and tickets.

    209 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Iflytek PDF Image OCR

    iflytek/iFly-Skills

    ifly-pdf-image-ocr skill supporting both image OCR (AI-powered LLM OCR) and PDF document recognition.

    209 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

Questions about Iflytek Video Translate

What does Iflytek Video Translate do?

A skill your agent uses when user asks to translate videos, dub video content, or localize videos into other languages. Iflytek Video Translate is an agent skill from iflytek/iFly-Skills. Use when user asks to translate videos, dub video content, or localize videos into other languages.

When should I use Iflytek Video Translate?

Iflytek Video Translate fits situations like: user asks to translate videos; dub video content; localize videos into other languages.

How do I install Iflytek Video Translate in Claude Code?

Run `npx skills add iflytek/iFly-Skills --skill iflytek-video-translate -a claude-code`. Or copy the skill folder (skills/iflytek-video-translate in iflytek/iFly-Skills) into .claude/skills/iflytek-video-translate in your project. Claude Code loads it when a task matches its description.

How do I install Iflytek Video Translate in Codex?

Run `npx skills add iflytek/iFly-Skills --skill iflytek-video-translate -a codex`. Or copy the skill folder (skills/iflytek-video-translate in iflytek/iFly-Skills) into .agents/skills/iflytek-video-translate in your project. Codex loads it when a task matches its description.

Can I use Iflytek Video Translate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add iflytek/iFly-Skills --skill iflytek-video-translate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/iflytek-video-translate, .gemini/skills/iflytek-video-translate, .github/skills/iflytek-video-translate and .opencode/skills/iflytek-video-translate in your project.

What does Iflytek Video Translate need to run?

Going by SKILL.md and its folder, Iflytek Video Translate needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and pip) and credentials named IFLY_API_KEY and IFLY_API_SECRET. Our summary lists: Python 3; A credential in IFLY_API_KEY; A credential in IFLY_API_SECRET.

Does Iflytek Video Translate access the network?

SKILL.md names 1 domain. In commands or code: spark-api-test.xf-yun.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Iflytek Video Translate safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Iflytek Video Translate use?

Iflytek Video Translate is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Iflytek Video Translate use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Iflytek Video Translate?

Skills that share tags, products or a category with Iflytek Video Translate: Video Translator (InsiderX-Pro/video-translator, 928 stars), Wjs Localizing Video (jianshuo/claude-skills, 131 stars), Translation Diff Export (Devolutions/UniGetUI, 26k stars) and Translation Diff Import (Devolutions/UniGetUI, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Iflytek Video Translate?

iflytek (a GitHub organization) maintains it in iflytek/iFly-Skills, which has 209 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: iflytek/iFly-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.