<?php
    $openApiURL = "http://aiopen.etri.re.kr:8000/WiseASR/Pronunciation"; // 영어 
    //$openApiURL = "http://aiopen.etri.re.kr:8000/WiseASR/PronunciationKor"; //한국어
     
    $accessKey = "YOUR_ACCESS_KEY";
    $languageCode = "LANGUAGE_CODE";
    $script = "PRONUNCIATION_SCRIPT";
    $audioFilePath = "AUDIO_FILE_PATH";
    $audioContents = base64_encode( file_get_contents($audioFilePath ) );
 
    $request = array(   
        "argument" => array (
            "language_code" => $languageCode,
            "script" => $script,
            "audio" => $audioContents
        )
    );
 
    try {
        $server_output = "";
        $ch = curl_init();
        $header = array(
            "Content-Type:application/json; charset=UTF-8",
            "Authorization":{$accessKey}
        );
        curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
        curl_setopt($ch, CURLOPT_URL, $openApiURL);
        curl_setopt($ch, CURLOPT_VERBOSE, true);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode ( $request) );
 
        $server_output = curl_exec ($ch);
        if($server_output === false) {
            echo "Error Number:".curl_errno($ch)."\n";
            echo "Error String:".curl_error($ch)."\n";
        }
 
        curl_close ($ch);
    } catch ( Exception $e ) {
        echo $e->getMessage ();
    }
 
    echo "result = " . var_dump($server_output);
?>

JSON parsing을 위해 jsoncpp 라이브러리를 사용하여 제공하고 있습니다. jsoncpp 라이브러리에 대한 자세한 설명은 https://github.com/open-source-parsers/jsoncpp 에서 확인 하실 수 있습니다.

HTTP 통신을 위해 curl 라이브러리를 사용하여 제공하고 있습니다. curl 라이브러리에 대한 자세한 설명은 https://curl.haxx.se/libcurl 에서 확인 하실 수 있습니다.

컴파일을 위해서는 아래와 같이 추가된 LIB에 대한 옵션을 추가해야 합니다.

g++ (c++파일명) (JSONCPP)/json/json.h (JSONCPP)/json/json-forwards.h (JSONCPP)/jsoncpp.cpp -I(CURL)/include -lcurl

  #include <curl/curl.h>
  #include <json/json.h>
  #include <iostream>
  #include <string>
  #include <memory.h>
  #include <fstream>
  #include <math.h>
   
   
  #define LENFRAME  800
   
  using namespace std;
   
  size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, string stream);
  string base64_encode(unsigned char const* , unsigned int len);
   
  static const string base64_chars =
               "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
               "abcdefghijklmnopqrstuvwxyz"
               "0123456789+/";
  int main() {
      char* openApiURL = (char*)"http://aiopen.etri.re.kr:8000/WiseASR/Pronunciation"; // 영어 
      //char* openApiURL = (char*)"http://aiopen.etri.re.kr:8000/WiseASR/PronunciationKor"; //한국어 
       
      char* audioFilePath = (char*)"AUDIO_FILE_PATH";
      string accessKey = "YOUR_ACCESS_KEY";
      string script = "PRONUNCIATION_SCRIPT";
      string languageCode = "LANGUAGE_CODE";
   
      Json::Value request;
      Json::Value argument;
      FILE* fp = fopen(audioFilePath, "rt" );
      unsigned char sbuf[LENFRAME];
      unsigned int nRead = 0;
      unsigned int nWrite = 0;
   
      unsigned char* audioBytes;
      unsigned char* newAudioBytes;
      while ( 0 < ( nRead = fread( sbuf, sizeof( char ), LENFRAME, fp ) ) ) {
          newAudioBytes = new unsigned char[nWrite + nRead];
          if ( 0 < nWrite ) {
              memcpy(newAudioBytes, audioBytes, nWrite * sizeof(char));
          }
          memcpy(newAudioBytes + nWrite, sbuf, nRead * sizeof(char));
          nWrite = nWrite + nRead;
          audioBytes = new unsigned char[nWrite];
          memcpy(audioBytes, newAudioBytes, nWrite * sizeof(char));
      }
      fclose(fp);
   
      argument["language_code"] = languageCode;
      argument["script"] = script;
      argument["audio"] = base64_encode( audioBytes , nWrite);
  
      request["argument"] = argument;
   
      CURL *curl;
      curl_slist* responseHeaders = NULL;
      curl = curl_easy_init();
   
      if( curl == NULL ) {
      } else {
          responseHeaders = curl_slist_append( responseHeaders , "Content-Type: application/json; charset=UTF-8" ) ;
          responseHeaders = curl_slist_append(responseHeaders , ("Authorization: " + accessKey).c_str() ) ; 
          string requestJson = request.toStyledString();
          long statusCode;
          string response;
   
          curl_easy_setopt(curl, CURLOPT_URL, openApiURL);
          curl_easy_setopt(curl, CURLOPT_HTTPHEADER, responseHeaders ) ;
          curl_easy_setopt(curl, CURLOPT_TIMEOUT, 5);
          curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
          curl_easy_setopt(curl, CURLOPT_POSTFIELDS, requestJson.c_str());
          curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeDataFunc);
          curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
   
          curl_easy_perform(curl);
   
          curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &statusCode);
          curl_easy_cleanup(curl);
   
          cout << "[responseCode] " << statusCode << endl;
          cout << "[responBody]" << endl;
          cout << response << endl;
      }
   
      return 0;
  }
   
  size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, string stream) {
      size_t realsize = size * nmemb;
      string temp(static_cast<const char*>(ptr), realsize);
      stream.append(temp);
      return realsize;
  }
   
  string base64_encode(unsigned char const* bytes_to_encode, unsigned int in_len) {
      string ret;
      int i = 0;
      int j = 0;
      unsigned char char_array_3[3];
      unsigned char char_array_4[4];
   
      while (in_len--) {
      char_array_3[i++] = *(bytes_to_encode++);
      if (i == 3) {
          char_array_4[0] = (char_array_3[0] & 0xfc) >> 2;
          char_array_4[1] = ((char_array_3[0] & 0x03) << 4) + ((char_array_3[1] & 0xf0) >> 4);
          char_array_4[2] = ((char_array_3[1] & 0x0f) << 2) + ((char_array_3[2] & 0xc0) >> 6);
          char_array_4[3] = char_array_3[2] & 0x3f;
   
          for(i = 0; (i <4) ; i++)
              ret += base64_chars[char_array_4[i]];
          i = 0;
      }
      }
   
      if (i) {
      for(j = i; j < 3; j++)
          char_array_3[j] = '\0';
   
      char_array_4[0] = (char_array_3[0] & 0xfc) >> 2;
      char_array_4[1] = ((char_array_3[0] & 0x03) << 4) + ((char_array_3[1] & 0xf0) >> 4);
      char_array_4[2] = ((char_array_3[1] & 0x0f) << 2) + ((char_array_3[2] & 0xc0) >> 6);
      char_array_4[3] = char_array_3[2] & 0x3f;
   
      for (j = 0; (j < i + 1); j++)
          ret += base64_chars[char_array_4[j]];
   
      while((i++ < 3))
          ret += '=';
      }
      return ret;
  }

python 3.0을 기준으로 작성되었습니다.

HTTP 통신을 위해 urllib3 라이브러리를 사용하여 제공하고 있습니다. Python 3.0 이하의 버전에서 예제를 실행하기 위해서는 별도로 urllib3의 설치가 필요합니다. 설치에 대한 설명은 https://pypi.python.org/pypi/urllib3 를 참고하시기 바랍니다. urllib3 라이브러리에 대한 자세한 설명은 https://urllib3.readthedocs.io/en/latest/ 에서 확인 하실 수 있습니다.

  #-*- coding:utf-8 -*-
  import urllib3
  import json
  import base64
  openApiURL = "http://aiopen.etri.re.kr:8000/WiseASR/Pronunciation" # 영어
  # openApiURL = "http://aiopen.etri.re.kr:8000/WiseASR/PronunciationKor" # 한국어
   
  accessKey = "YOUR_ACCESS_KEY"
  audioFilePath = "AUDIO_FILE_PATH"
  languageCode = "LANGUAGE_CODE"
  script = "PRONUNCIATION_SCRIPT"
   
  file = open(audioFilePath, "rb")
  audioContents = base64.b64encode(file.read()).decode("utf8")
  file.close()
   
  requestJson = {   
      "argument": {
          "language_code": languageCode,
          "script": script,
          "audio": audioContents
      }
  }
   
  http = urllib3.PoolManager()
  response = http.request(
      "POST",
      openApiURL,
      headers={"Content-Type": "application/json; charset=UTF-8","Authorization": accessKey},
      body=json.dumps(requestJson)
  )
   
  print("[responseCode] " + str(response.status))
  print("[responBody]")
  print(str(response.data,"utf-8"))

var fs = require('fs');
var openApiURL = 'http://aiopen.etri.re.kr:8000/WiseASR/Pronunciation'; //영어 
//var openApiURL = 'http://aiopen.etri.re.kr:8000/WiseASR/PronunciationKor'; //한국어 
 
var accessKey = 'YOUR_ACCESS_KEY';
var languageCode = 'LANGUAGE_CODE';
var script = 'PRONUNCIATION_SCRIPT';
var audioFilePath = 'AUDIO_FILE_PATH';
var audioData;
 
var audioData = fs.readFileSync(audioFilePath);
 
var requestJson = {
    'argument': {
        'language_code': languageCode,
        'script': script,
        'audio': audioData.toString('base64')
    }
};
 
var request = require('request');
var options = {
    url: openApiURL,
    body: JSON.stringify(requestJson),
    headers: {'Content-Type':'application/json,'Authorization':access_key}
};
request.post(options, function (error, response, body) {
    console.log('responseCode = ' + response.statusCode);
    console.log('responseBody = ' + body);
});

발음평가 API는 요청된 어휘의 동음이의어 정보 결과를 JSON 형태의 Text 데이터로 반환합니다.

다음은 정상적인 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Response Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Response Body]
{
    "request_id": "reserved field",
    "result": 0,
    "return_object": {발음평가 결과 JSON}
}

다음은 오류가 발생한 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Response Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Response Body]
{
    "request_id": "reserved field",
    "result": -1,
    "reason": {오류 메시지}
}

분석된 결과는 다음과 같은 내용이 포함되어 있습니다.

발음평가 API의 오류 코드 목록은 다음과 같습니다.