Flow

Execute Flow

post

파일 업로드 또는 URL 입력을 받아 Flow를 실행합니다.

입력 방식 (둘 중 하나 선택):

1. URL 방식

• input_type: "url"

• input: 실제 URL 주소 (예: https://example.com/video.mp4, YouTube 링크 등)

1. 파일 업로드 방식

• input_type: "file"

• file: 업로드할 미디어 파일

플로우별 응답 차이점:

• audion_vu: 음성 이해, 감정 분석, MLLM 요약

• audion_vh: 보이스 하이라이트(음성 하이라이트, 세그먼트 정보 포함)

선택적 응답 필드:

• youtubeInfo: YouTube URL 입력 시에만 제공

• segments: audion_vh 플로우에서만 제공 (화자별 시간 구간)

• voice_highlight: audion_vh 플로우에서만 제공 (각 발화별 음성 분석)

Header parameters

AuthorizationstringOptional

Audion

Body

multipart/form-data

input_typestringRequired

입력 방식: url 또는 file

flowstringRequired

플로우 타입: audion_vu 또는 audion_vh

inputstringOptional

[input_type=url 일 때 필수] YouTube 또는 미디어 파일 URL

filestring · binaryOptional

[input_type=file 일 때 필수] 업로드할 미디어 파일

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/flow

HTTPcURLJavaScriptPython

POST /api-key/v1/flow HTTP/1.1
Host: audion.magovoice.com
Content-Type: multipart/form-data
Accept: */*
Content-Length: 66

{
  "input_type": "text",
  "flow": "text",
  "input": "text",
  "file": "binary"
}

{
  "content": {
    "documentId": "12345678-1234-1234-1234-123456789abc",
    "filePath": "uploads/audio/sample.mp4",
    "flowingTime": 5.25,
    "output": {
      "mediaInfo": {
        "bits_per_raw_sample": "16",
        "channels": 2,
        "codec_name": "aac",
        "codec_type": "audio",
        "duration": "120.500000",
        "sample_fmt": "fltp",
        "sample_rate": "44100"
      },
      "mllm": {},
      "segments": [
        {}
      ],
      "speakerInfo": {
        "duration": {
          "SPEAKER_01": 60.5
        },
        "num_speakers": 2,
        "speakers": [
          "SPEAKER_01",
          "SPEAKER_02"
        ]
      },
      "srt": "subtitles/sample.srt",
      "utterances": [
        {
          "emotion": "NEUTRAL",
          "emotion_info": {
            "best_emotion": "NEUTRAL",
            "decoding_time": 1.5,
            "emotion": {
              "ANGRY": 5,
              "HAPPINESS": 30,
              "NEUTRAL": 45,
              "SADNESS": 15,
              "SURPRISE": 5
            },
            "filename": "audio/segment_001.wav",
            "principal_vocal_biomarkers": {
              "brightness": 850.5,
              "pitch": 180.25,
              "pitch_variation": 25.8,
              "rms": 0.15,
              "snr": 4.2
            },
            "result_path": "analysis/emotion_001.json"
          },
          "end": 15.5,
          "filename": "audio/segment_001.wav",
          "id": "segment_001",
          "score": -0.25,
          "speaker": "SPEAKER_01",
          "speed_info": {
            "speech_level": "1",
            "speed": 5.5
          },
          "start": 10.2,
          "text": "안녕하세요. 오늘 날씨가 정말 좋네요.",
          "voice_highlight": {}
        }
      ],
      "vtt": "subtitles/sample.vtt"
    },
    "resultPath": "results/output/result.json",
    "thumbnailPath": "thumbnails/sample.jpg",
    "uploadFilename": "sample_audio.mp3",
    "youtubeInfo": {
      "audioPath": "youtube/audio/sample.mp3",
      "metadata": {
        "description": "샘플 영상 설명입니다.",
        "dislike_count": 5,
        "duration": 120,
        "id": "dQw4w9WgXcQ",
        "like_count": 1000,
        "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
        "title": "샘플 영상 제목",
        "upload_date": "20240101",
        "uploader": "Sample Channel",
        "view_count": 50000,
        "webpage_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
      },
      "videoPath": "youtube/video/sample.mp4"
    }
  },
  "message": "Flow execution completed",
  "status": "success"
}