Quickstart

API 사용을 위한 빠른 시작 가이드

Stage 1. Get your API key

UNIVA AI Platform의 모든 서비스는 API key를 통해 이용하실 수 있습니다.

API key 발급 절차

Tips. API key 발급 필요 사항

AI Platform 회원가입
계정 신용카드 등록

UNIVA AI Platform 좌측 메뉴, API Keys에서 + API Key 생성하기 클릭
비밀 키 생성 팝업에서 API Key 생성 버튼 클릭
생성된 API Key 확인

Stage 2. First API request

curl -X POST 'https://aiplatform-api.rest.univa.co.kr/rest/v1/text/llm' \
    -H 'Content-Type: application/json' \
    -H 'x-api-key: UNIVA-API-KEY' \
    -d '{
        "data": {
            "model": "llm-250826",
            #  버전 설정 방법 : llm-{version}
            "stream": false,
            "messages": [
                {
                    "role": "system",
                    "content": "당신은 AI 챗봇 입니다. 사용자의 질문에 자세하고 친절하게 답변하세요."
                },
                {
                    "role": "user",
                    "content": "커피와 어울리는 디저트를 추천해줘"
                }
            ],
            "max_tokens": 120000,
            "temperature": 0.7,
            "top_p": 1,
            "top_k": -1,
            "repetition_penalty": 1.15
        }
    }'

const axios = require('axios')

const apiKey = 'UNIVA-API-KEY'
const apiUrl =
  'https://aiplatform-api.rest.univa.co.kr/rest/v1/text/llm'

const data = {
  data: {
    model: 'komodo-small',
    //  버전 설정 방법 : komodo-small-{version}
    stream: false,
    messages: [
      {
        role: 'system',
        content:
          '당신은 AI 챗봇 입니다. 사용자의 질문에 자세하고 친절하게 답변하세요.',
      },
      {
        role: 'user',
        content: '커피와 어울리는 디저트를 추천해줘',
      },
    ],
    max_tokens: 120000,
    temperature: 0.01,
    top_p: 0.9,
    top_k: 20,
    repetition_penalty: 1.15,
  },
}

async function komodoPostRequest() {
  try {
    const response = await axios.post(apiUrl, data, {
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': apiKey,
      },
    })

    // 응답 처리
    if (response.status === 200) {
      console.log('응답 데이터:', response.data)
      // response.data를 파일로 저장하거나 다른 작업을 수행할 수 있습니다.
    } else {
      console.log('요청 실패:', response.statusText)
    }
  } catch (error) {
    console.error('에러 발생:', error)
  }
}

komodoPostRequest()

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import java.io.IOException;

public class HttpPostExample {
    public static void main(String[] args) {
        String apiKey = "UNIVA-API-KEY"; // API 키를 입력하세요.
        String url = "https://aiplatform-api.rest.univa.co.kr/rest/v1/text/llm";

        CloseableHttpClient httpClient = HttpClients.createDefault();

        HttpPost httpPost = new HttpPost(url);
        httpPost.setHeader("Content-Type", "application/json");
        httpPost.setHeader("x-api-key", apiKey); // API 키를 헤더에 추가합니다.

        // JSON 형식의 body 데이터
        String json = "{\"data\":{\"model\":\"llm-250826\",\"stream\":false,\"messages\":[{\"role\":\"system\",\"content\":\"당신은 AI 챗봇 입니다. 사용자의 질문에 자세하고 친절하게 답변하세요.\"},{\"role\":\"user\",\"content\":\"커피와 어울리는 디저트를 추천해줘\"}],\"max_tokens\":120000,\"temperature\":0.01,\"top_p\":0.9,\"top_k\":20,\"repetition_penalty\":1.15}}";
        //  버전 설정 방법 : llm-{version}
        StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON);

        httpPost.setEntity(entity);

        try {
            HttpResponse response = httpClient.execute(httpPost);
            HttpEntity responseEntity = response.getEntity();
            String responseString = EntityUtils.toString(responseEntity, "UTF-8");
            System.out.println(responseString);
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                httpClient.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

import requests
import json

url = 'https://aiplatform-api.rest.univa.co.kr/rest/v1/text/llm'
api_key = 'UNIVA-API-KEY' # API 키를 입력하세요.

headers = {
    'Content-Type': 'application/json',
    'x-api-key': api_key
}

data = {
    "data" :  {
        "model": "llm-250826",
        #  버전 설정 방법 : llm-{version}
        "stream": False,
        "messages": [
                {
                    "role": "system",
                    "content": "당신은 AI 챗봇 입니다. 사용자의 질문에 자세하고 친절하게 답변하세요."
                },
                {
                    "role": "user",
                    "content": "사용자 입력 텍스트"
                }
        ],
        "max_tokens": 120000, 
        # max_tokens 길이 최대값 120000
        "temperature": 0.7,
        "top_p": 1,
        "top_k": -1,
        "repetition_penalty": 1.15
    }
}

response = requests.post(url, headers=headers, data=json.dumps(data))

# API 호출 결과 확인
if response.status_code == 200:
    result = response.json()

else:
    print("Error Code :", response.status_code)
    result = response.json()

result

Stage 3. Check response

{'success': True,
 'result': {'id': 'chatcmpl-49858509-f4af-4ee5-9613-571dde239279',
  'object': 'chat.completion',
  'created': 1756836934,
  'choices': [{'index': 0,
    'message': {'role': 'assistant',
     'reasoning_content': None,
     'content': '모델 응답 텍스트',
     'tool_calls': []},
    'logprobs': None,
    'finish_reason': 'stop',
    'stop_reason': None}],
  'usage': {'prompt_tokens': 222,
   'total_tokens': 1238,
   'completion_tokens': 1016,
   'prompt_tokens_details': None},
  'prompt_logprobs': None}}

PreviousIntroduction NextOur Models

Last updated 3 months ago

import org.apache.http.HttpEntity; import org.apache.http.HttpResponse; import org.apache.http.client.methods.HttpPost; import org.apache.http.entity.ContentType; import org.apache.http.entity.StringEntity; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import java.io.IOException; public class HttpPostExample { public static void main(String[] args) { String apiKey = "UNIVA-API-KEY"; // API 키를 입력하세요. String url = "https://aiplatform-api.rest.univa.co.kr/rest/v1/text/llm"; CloseableHttpClient httpClient = HttpClients.createDefault(); HttpPost httpPost = new HttpPost(url); httpPost.setHeader("Content-Type", "application/json"); httpPost.setHeader("x-api-key", apiKey); // API 키를 헤더에 추가합니다. // JSON 형식의 body 데이터 String json = "{\"data\":{\"model\":\"llm-250826\",\"stream\":false,\"messages\":[{\"role\":\"system\",\"content\":\"당신은 AI 챗봇 입니다. 사용자의 질문에 자세하고 친절하게 답변하세요.\"},{\"role\":\"user\",\"content\":\"커피와 어울리는 디저트를 추천해줘\"}],\"max_tokens\":120000,\"temperature\":0.01,\"top_p\":0.9,\"top_k\":20,\"repetition_penalty\":1.15}}"; // 버전 설정 방법 : llm-{version} StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON); httpPost.setEntity(entity); try { HttpResponse response = httpClient.execute(httpPost); HttpEntity responseEntity = response.getEntity(); String responseString = EntityUtils.toString(responseEntity, "UTF-8"); System.out.println(responseString); } catch (IOException e) { e.printStackTrace(); } finally { try { httpClient.close(); } catch (IOException e) { e.printStackTrace(); } } } }