Alicloud Ai Audio Tts

interface:
  display_name: "Alibaba Cloud AI Audio TTS"
  short_description: "Alibaba Cloud TTS and speech workflows"
  default_prompt: "Use $alicloud-ai-audio-tts to complete this ai/audio task on Alibaba Cloud."

#!/usr/bin/env python3
"""Generate speech audio using DashScope (qwen3-tts-flash) from a normalized request.

Usage:
  python scripts/generate_tts.py --request '{"text":"Hello","voice":"Cherry"}'
  python scripts/generate_tts.py --file request.json --output output/ai-audio-tts/audio/voice.wav
"""

from __future__ import annotations

import argparse
import configparser
import json
import os
import sys
import urllib.request
from pathlib import Path
from typing import Any

try:
    import dashscope
except ImportError:
    print("Error: dashscope is not installed. Run: pip install dashscope", file=sys.stderr)
    sys.exit(1)


MODEL_NAME = "qwen3-tts-flash"
DEFAULT_VOICE = "Cherry"
DEFAULT_LANGUAGE = "Auto"


def _find_repo_root(start: Path) -> Path | None:
    for parent in [start] + list(start.parents):
        if (parent / ".git").exists():
            return parent
    return None


def _load_dotenv(path: Path) -> None:
    if not path.exists():
        return
    for line in path.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith("#") or "=" not in line:
            continue
        key, value = line.split("=", 1)
        key = key.strip()
        value = value.strip().strip('"').strip("'")
        if key and key not in os.environ:
            os.environ[key] = value


def _load_env() -> None:
    _load_dotenv(Path.cwd() / ".env")
    repo_root = _find_repo_root(Path(__file__).resolve())
    if repo_root:
        _load_dotenv(repo_root / ".env")


def _load_dashscope_api_key_from_credentials() -> None:
    if os.environ.get("DASHSCOPE_API_KEY"):
        return
    credentials_path = Path(os.path.expanduser("~/.alibabacloud/credentials"))
    if not credentials_path.exists():
        return
    config = configparser.ConfigParser()
    try:
        config.read(credentials_path)
    except configparser.Error:
        return
    profile = os.getenv("ALIBABA_CLOUD_PROFILE") or os.getenv("ALICLOUD_PROFILE") or "default"
    if not config.has_section(profile):
        return
    key = config.get(profile, "dashscope_api_key", fallback="").strip()
    if not key:
        key = config.get(profile, "DASHSCOPE_API_KEY", fallback="").strip()
    if key:
        os.environ["DASHSCOPE_API_KEY"] = key


def load_request(args: argparse.Namespace) -> dict[str, Any]:
    if args.request:
        return json.loads(args.request)
    if args.file:
        with open(args.file, "r", encoding="utf-8") as f:
            return json.load(f)
    raise ValueError("Either --request or --file must be provided")


def call_generate(req: dict[str, Any]) -> dict[str, Any]:
    text = req.get("text")
    if not text:
        raise ValueError("text is required")

    dashscope.base_http_api_url = req.get(
        "base_url", "https://dashscope.aliyuncs.com/api/v1"
    )

    response = dashscope.MultiModalConversation.call(
        model=MODEL_NAME,
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        text=text,
        voice=req.get("voice", DEFAULT_VOICE),
        language_type=req.get("language_type", DEFAULT_LANGUAGE),
        stream=False,
    )

    audio = response.output.audio
    audio_url = audio.url
    return {
        "audio_url": audio_url,
        "sample_rate": audio.get("sample_rate"),
        "format": audio.get("format"),
    }


def download_audio(audio_url: str, output_path: Path) -> None:
    output_path.parent.mkdir(parents=True, exist_ok=True)
    with urllib.request.urlopen(audio_url) as response:
        output_path.write_bytes(response.read())


def main() -> None:
    parser = argparse.ArgumentParser(description="Generate audio with qwen3-tts-flash")
    parser.add_argument("--request", help="Inline JSON request string")
    parser.add_argument("--file", help="Path to JSON request file")
    default_output_dir = Path(os.getenv("OUTPUT_DIR", "output")) / "ai-audio-tts" / "audio"
    parser.add_argument(
        "--output",
        default=str(default_output_dir / "output.wav"),
        help="Output audio path",
    )
    parser.add_argument("--print-response", action="store_true", help="Print normalized response JSON")
    args = parser.parse_args()

    _load_env()
    _load_dashscope_api_key_from_credentials()
    if not os.environ.get("DASHSCOPE_API_KEY"):
        print(
            "Error: DASHSCOPE_API_KEY is not set. Configure it via env/.env or ~/.alibabacloud/credentials.",
            file=sys.stderr,
        )
        print("Example .env:\n  DASHSCOPE_API_KEY=your_key_here", file=sys.stderr)
        print(
            "Example credentials:\n  [default]\n  dashscope_api_key=your_key_here",
            file=sys.stderr,
        )
        sys.exit(1)

    req = load_request(args)
    result = call_generate(req)
    download_audio(result["audio_url"], Path(args.output))

    if args.print_response:
        print(json.dumps(result, ensure_ascii=True))


if __name__ == "__main__":
    main()