Python

음성 AI 구현의 복잡함을 없애고, 비즈니스 가능성을 확장하세요.

Repository: github.com/holamago/audion-python-sdk

목차

• 요구사항

• 설치

• 빠른 시작

• API 문서

• 사용 예제

• 문서

• 라이선스

• 지원

• 버전 히스토리

요구사항

• Python 3.10+

• API 키 (Audion 서비스 등록 필요)

  • 회원가입 후 API Key 발급 받아야 합니다.

설치

pip을 사용하여 설치 (PyPI 패키지 이름: audionlib):

pip install audionlib

또는 개발용으로 레포를 클론하여 editable 모드로 설치:

git clone https://github.com/holamago/audion-python-sdk.git
cd audion-python-sdk

python -m venv venv
source venv/bin/activate

pip install -e .

빠른 시작

1. 클라이언트 초기화

from audion import AudionClient

# API 키로 클라이언트 초기화
client = AudionClient(api_key="your-api-key-here")

2. 로컬 파일 처리

• 오디오/비디오 업로드

# 로컬 오디오/비디오 파일 처리
result = client.flow(
    flow="audion_vu",
    input_type="file",
    input="path/to/your/audio.wav"
)
print(result)

3. URL 처리

# YouTube URL 처리
result = client.flow(
    flow="audion_vu",
    input_type="url",
    input="<https://youtu.be/your-video-id>"
)
print(result)

API 문서

AudionClient

Audion 서비스의 메인 클라이언트 클래스입니다.

초기화

AudionClient(
    api_key: str,           # 필수: API 인증 키
    base_url: str = None,   # 선택: 서버 기본 URL
    timeout: float = 300    # 선택: 요청 타임아웃 (초)
)

매개변수:

• api_key (str, 필수): Audion 서비스 인증을 위한 API 키

• base_url (str, 선택): 서버의 기본 URL. 기본값은 프로덕션 서버

• timeout (float, 선택): HTTP 요청 타임아웃. 기본값은 300초

예외:

• ValueError: api_key가 제공되지 않은 경우

메서드

flow(flow, input_type, input)

지정된 플로우로 음성/비디오 처리를 실행합니다.

client.flow(
    flow: str,        # 실행할 플로우 이름
    input_type: str,  # 입력 타입: "file" 또는 "url"
    input: str        # 파일 경로 또는 URL
)

매개변수:

• flow (str): 실행할 플로우의 이름

  • 현재 지원하는 플로우:

    • audion_vu: Voice Understanding

    • audion_vh: Voice Highlight

  • Custom Flow 지원 가능 (email:[email protected])

• input_type (str): 입력 타입. file 또는 url

• input (str): 처리할 파일의 경로 또는 URL

반환값:

• dict: 처리 결과를 포함하는 JSON 응답

예외:

• ValueError: 지원하지 않는 input_type인 경우

• Exception: API 호출 실패 시

문서

• GitHub: github.com/holamago/audion-python-sdk

• 예제: examples/ 디렉토리

라이선스

이 프로젝트는 Apache License 2.0 하에 라이선스됩니다.

지원

• 홈페이지: Audion

• 이슈: GitHub Issues

• 이메일: [email protected]

버전 히스토리

• v0.1.2

  • PyPI 패키지 구성 정리 (pyproject.toml 기반 빌드)

  • SDK 내부 구조 정리 (로그 유틸과 코어/헬퍼 모듈 리팩토링)

  • 문서 개선 (README 정리 및 예제 링크 정리)

• v0.1.0

  • 초기 릴리스

  • 기본 flow API 지원

  • 파일 및 URL 입력 지원

  • 다중 오디오/비디오 형식 지원

Made with ❤️ by MAGO