Java

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

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

목차

• 요구사항

• 설치

• 빠른 시작

• API 문서

• 사용 예제

• 문서

• 라이선스

• 지원

• 버전 히스토리

요구사항

• Java 11+

• Maven 3.6+ or Gradle 6.8+

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

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

설치

의존성 추가 (권장)

Gradle

implementation 'com.magovoice:audion:0.1.0'

Maven

<dependency>
  <groupId>com.magovoice</groupId>
  <artifactId>audion</artifactId>
  <version>0.1.0</version>
</dependency>

소스에서 빌드

git clone https://github.com/holamago/audion-java-sdk.git
cd audion-java-sdk
mvn clean install

빠른 시작

1. 클라이언트 초기화

import com.magovoice.audion.AudionClient;
import com.magovoice.audion.model.FlowResponse;

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

2. 로컬 파일 처리

// 로컬 오디오/비디오 파일 처리
FlowResponse result = client.flow(
    "audion_vu",
    "file",
    "path/to/your/audio.wav"
);
System.out.println(result);

3. URL 처리

// YouTube URL 처리
FlowResponse result = client.flow(
    "audion_vu",
    "url",
    "https://youtu.be/your-video-id"
);
System.out.println(result);

API 문서

AudionClient

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

생성자

// 기본 생성자
AudionClient(String apiKey)
// 커스텀 URL과 함께
AudionClient(String apiKey, String baseUrl)
// 모든 옵션과 함께
AudionClient(String apiKey, String baseUrl, Integer timeout)

매개변수:

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

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

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

예외:

• IllegalArgumentException: apiKey가 제공되지 않은 경우

메서드

flow(flow, inputType, input)

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

FlowResponse flow(String flow, String inputType, String input) throws IOException

매개변수:

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

  • 현재 지원하는 플로우:

    • audion_vu: Voice Understanding

    • audion_vh: Voice Highlight

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

• inputType (String): 입력 타입. file 또는 url

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

반환값:

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

예외:

• IllegalArgumentException: 지원하지 않는 inputType인 경우

• IOException: API 호출 실패 시

getFlows()

사용 가능한 플로우 목록을 가져옵니다.

Object getFlows() throws IOException

사용 예제

호출 예시

로컬 오디오/비디오 파일을 처리하는 가장 단순한 호출 예시입니다.

import com.magovoice.audion.AudionClient;
import com.magovoice.audion.model.FlowResponse;

AudionClient client = new AudionClient("your-api-key-here");

FlowResponse result = client.flow(
    "audion_vu",
    "file",
    "samples/audio.wav"
);

System.out.println(result);

자세한 예제 코드는 Audion Java SDK 저장소의 example를 참고하세요.

문서

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

라이선스

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

지원

• 홈페이지: Audion

• 이슈: GitHub Issues

• 이메일: [email protected]

버전 히스토리

• v0.1.0: 초기 릴리스

  • 기본 flow API 지원

  • 파일 및 URL 입력 지원

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

  • Maven 프로젝트 구조

  • JUnit 테스트 포함

Made with ❤️ by MAGO