addis-assistant

TotalClaw 作者 totalclaw

使用 Addis Assistant API (api.addisassistant.com) 提供语音转文本 (STT) 和文本翻译。当用户需要将音频文件转换为文本（特别是阿姆哈拉语）或在语言之间翻译文本（例如，阿姆哈拉语到英语）时使用。需要“x-api-key”。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~dagmawibabi-addis-assistant-stt

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~dagmawibabi-addis-assistant-stt/file -o dagmawibabi-addis-assistant-stt.md

# Addis Assistant

## Overview

This skill enables the use of the Addis Assistant API for both Speech-to-Text (STT) and text Translation.

## Using This Skill

This skill provides two primary functions:

1.  **Speech-to-Text (STT):** Convert an audio file (e.g., Amharic) into text.
2.  **Translation:** Translate text from a source language to a target language.

### Authentication

Both functions require an `x-api-key`. This key should be provided as an argument to the respective scripts.

### STT Function

-   **Endpoint:** `api.addisassistant.com/api/v2/stt`
-   **Method:** `POST`
-   **Parameters:**
    -   `audio`: Path to the audio file (e.g., `"@/path/to/file"`)
    -   `request_data`: JSON string with `"language_code": "am"` (Amharic is the default and only supported language for now).

### Translation Function

-   **Endpoint:** `api.addisassistant.com/api/v1/translate`
-   **Method:** `POST`
-   **Parameters:**
    -   `text`: The text to be translated.
    -   `source_language`: The language of the input text (e.g., `"am"`).
    -   `target_language`: The language to translate the text into (e.g., `"en"`).

## Resources

This skill includes `scripts/` for direct execution and `references/` for API details.

### scripts/

-   `stt.py`: Python script for Speech-to-Text.
-   `translate.py`: Python script for text Translation.

### references/

-   `api_spec.md`: Detailed API specifications and curl examples.

---

## 中文说明

# Addis Assistant

## 概述

此技能支持使用 Addis Assistant API 实现语音转文本 (STT) 和文本翻译两项功能。

## 使用此技能

此技能提供两个主要功能：

1.  **语音转文本 (STT)：** 将音频文件（例如阿姆哈拉语）转换为文本。
2.  **翻译：** 将文本从源语言翻译为目标语言。

### 认证

两项功能均需要 `x-api-key`。此密钥应作为参数传递给相应的脚本。

### STT 功能

-   **Endpoint:** `api.addisassistant.com/api/v2/stt`
-   **Method:** `POST`
-   **Parameters:**
    -   `audio`：音频文件的路径（例如 `"@/path/to/file"`）
    -   `request_data`：包含 `"language_code": "am"` 的 JSON 字符串（阿姆哈拉语是目前默认且唯一支持的语言）。

### 翻译功能

-   **Endpoint:** `api.addisassistant.com/api/v1/translate`
-   **Method:** `POST`
-   **Parameters:**
    -   `text`：要翻译的文本。
    -   `source_language`：输入文本的语言（例如 `"am"`）。
    -   `target_language`：要将文本翻译成的目标语言（例如 `"en"`）。

## 资源

此技能包含用于直接执行的 `scripts/` 和提供 API 详情的 `references/`。

### scripts/

-   `stt.py`：用于语音转文本的 Python 脚本。
-   `translate.py`：用于文本翻译的 Python 脚本。

### references/

-   `api_spec.md`：详细的 API 规范和 curl 示例。