Ollang — Master Skill
This is the entry point for all Ollang API operations. Based on the user's intent, delegate to the appropriate sub-skill below.
Sub-Skills
| Sub-Skill | When to Use |
|---|
| INLINECODE0 | User wants to check if the API is up |
| INLINECODE1 |
User wants to upload a video, audio, document, or VTT file |
|
ollang-order-create | User wants to create a translation, CC, subtitle, or dubbing order |
|
ollang-order-get | User wants to check the status or details of a specific order |
|
ollang-orders-list | User wants to list, search, or filter their orders |
|
ollang-order-cancel | User wants to cancel an order |
|
ollang-order-rerun | User wants to rerun or regenerate an order |
|
ollang-revision | User wants to report an issue or manage revisions on an order |
|
ollang-human-review | User wants to request or cancel human (linguist) review |
|
ollang-qc-eval | User wants to run a quality control evaluation on an order |
|
ollang-project | User wants to list or inspect projects |
|
ollang-folder | User wants to list or find folders |
Full Workflow
A complete end-to-end translation workflow looks like this:
CODEBLOCK0
Authentication
All endpoints (except health check) require the X-Api-Key header.
The API key is read from the OLLANG_API_KEY environment variable.
If the variable is not set, instruct the user to configure it:
export OLLANG_API_KEY=<your-api-key>
Get your API key at https://lab.ollang.com.
API Base URL
CODEBLOCK2
Behavior
- 1. Identify the user's intent from their message
- Map it to the correct sub-skill from the table above
- Read the API key from the
OLLANG_API_KEY environment variable. If not set, tell the user to set it with: INLINECODE15 - Execute the operation and present results clearly
- Suggest logical next steps (e.g., after upload → offer to create an order)
Ollang — 主技能
这是所有 Ollang API 操作的入口点。根据用户的意图，将任务委派给下方相应的子技能。
子技能
| 子技能 | 使用场景 |
|---|
| ollang-health | 用户想检查 API 是否正常运行 |
| ollang-upload |
用户想上传视频、音频、文档或 VTT 文件 |
| ollang-order-create | 用户想创建翻译、隐藏式字幕、字幕或配音订单 |
| ollang-order-get | 用户想查看特定订单的状态或详细信息 |
| ollang-orders-list | 用户想列出、搜索或筛选其订单 |
| ollang-order-cancel | 用户想取消订单 |
| ollang-order-rerun | 用户想重新运行或重新生成订单 |
| ollang-revision | 用户想报告问题或管理订单的修订 |
| ollang-human-review | 用户想请求或取消人工（语言专家）审核 |
| ollang-qc-eval | 用户想对订单进行质量控制评估 |
| ollang-project | 用户想列出或查看项目 |
| ollang-folder | 用户想列出或查找文件夹 |
完整工作流程
一个完整的端到端翻译工作流程如下：
- 1. 上传文件 → ollang-upload → 返回 projectId
- 创建订单 → ollang-order-create → 返回 orderId(s)
- 监控状态 → ollang-order-get → 轮询直至完成
- 质量检查 → ollang-qc-eval → 评分 + 片段分析
- 报告问题 → ollang-revision → 如有需要创建修订
- 升级为人工审核 → ollang-human-review → 可选的语言专家审核
身份验证
所有端点（健康检查除外）都需要 X-Api-Key 请求头。
API 密钥从 OLLANGAPIKEY 环境变量中读取。
如果该变量未设置，请指示用户进行配置：
bash
export OLLANGAPIKEY=
在 https://lab.ollang.com 获取您的 API 密钥。
API 基础 URL
https://api-integration.ollang.com
行为规则
- 1. 从用户消息中识别其意图
- 根据上表将其映射到正确的子技能
- 从 OLLANGAPIKEY 环境变量中读取 API 密钥。如果未设置，告知用户使用以下命令进行设置：export OLLANGAPIKEY=
- 执行操作并清晰呈现结果
- 建议逻辑上的后续步骤（例如，上传后 → 提供创建订单的选项）
