본문으로 건너뛰기

API 배포 및 릴리즈 가이드

image-20241104-070152.png

예상 소요 시간: 10분

LaaS의 API 배포 및 릴리즈 기능을 활용하여 프리셋을 API로 배포하고, 버전 관리 및 롤백 기능을 효율적으로 운영하는 방법을 익혀보세요. 배포 후 API 엔드포인트를 확인하고 이를 서비스에 연동하는 방법도 포함되어 있습니다.

LaaS 무료 체험하기

1. 개요​

LaaS의 API 배포 및 릴리즈 기능을 사용하면 프리셋을 특정 시점에 맞게 API로 배포하고, 이를 서비스에 연동할 수 있습니다.
이 기능을 통해 개발자는 안정적으로 버전별 API를 관리할 수 있으며, 필요에 따라 이전 버전으로 롤백할 수 있습니다.

🔹 주요 기능​

  • 프리셋을 API로 변환하여 배포 가능

  • 배포된 API 버전 관리 및 롤백 지원

  • 기존 배포된 버전 비교 및 수정 이력 확인

  • 서비스 중단 및 최신 버전으로 재설정 가능

  • 배포 후 API 엔드포인트 확인 가능

2. API 배포 및 릴리즈 기능 사용 방법​

2.1 API 배포 방법​

  1. 프리셋 작성 및 저장

    • 에디터에서 새로운 프리셋을 작성합니다.

    • “저장” 버튼을 클릭하여 현재 프리셋을 저장합니다.

      image-20250305-061546.png



  2. API 배포 시작

    • 저장한 프리셋을 API 배포 & 릴리즈 버튼을 통해 배포합니다.

    • 배포된 시간이 표시되며, 이를 통해 최신 배포 버전을 확인할 수 있습니다.

      image-20250305-061605.png

  3. 배포 내역 확인

    • 좌측 메뉴에서 "배포" 탭을 선택하면 최신 배포된 API 정보를 확인할 수 있습니다.

    • 프로젝트, 프리셋, 배포 시간, 사용 모델 및 버전 정보가 표시됩니다.

      image-20250305-061645.png


2.2 배포된 API 관리​

  1. 서비스 중단

    • 현재 배포된 API를 비활성화하려면 "서비스 중단" 버튼을 클릭하세요.

    • 서비스가 중단되면 해당 API는 더 이상 호출할 수 없습니다.

      image-20250305-061700.png

  2. 이전 버전으로 롤백

    • 배포 목록에서 원하는 버전(v0.8 등)을 선택하면 해당 배포 정보를 확인할 수 있습니다.

    • "최신 버전으로 설정"을 클릭하면 해당 버전이 활성화됩니다.

      image-20250305-061715.png

  3. API 배포 상세 정보 확인

    • 각 배포 버전의 상세 설정(JSON 데이터 포함)을 확인할 수 있습니다.

    • "요약 데이터" 및 "원본 데이터"를 통해 현재 설정 값을 비교할 수 있습니다.

      image-20250305-061731.png

3. 배포 후 API 엔드포인트 확인 및 활용​

API를 배포한 후, 해당 API의 엔드포인트를 확인할 수 있습니다.
이 엔드포인트를 사용하여 서비스와 연동할 수 있으며, 이를 통해 배포된 프리셋을 API로 호출할 수 있습니다.

  1. 코드 보기 기능 활성화

    • 에디터 화면에서 코드 아이콘을 클릭하여 API 엔드포인트 및 요청 형식을 확인합니다.

      image-20250305-061748.png

  2. API 요청 예제 확인

    • JavaScript, Python 등 다양한 언어의 예제 코드가 제공되며, 이를 복사하여 사용할 수 있습니다.

      image-20250305-061802.png

  3. API 엔드포인트 및 요청 방식 예제

    아래는 JavaScript(axios)를 사용하여 배포된 API를 호출하는 예제입니다.

    const axios = require('axios');

    async function requestChatCompletion() {
        const headers = {
            project: 'ddee95fe52',
            apiKey: 'YOUR_API_KEY_HERE',
            'Content-Type': 'application/json; charset=utf-8'
        };

        const body = {
            hash: 'b4d2bf94b8a2b811fec056239b2d124bfaf6bcd712f6766da59f7081905c45ca',
            params: {}
        };

        const response = await axios.post(
            'https://api-laas.wanted.co.kr/api/preset/v2/chat/completions',
            body,
            { headers }
        );

        console.log('Response:', response.data);
    }

    📌 주요 사항

    • project: 배포된 프로젝트의 ID

    • apiKey: 사용자의 API 키 (보안 유의)

    • hash: 특정 프리셋을 식별하는 해시 값

    • https://api-laas.wanted.co.kr/api/preset/v2/chat/completions 엔드포인트로 요청

이제 배포된 API 엔드포인트를 활용하여 LLM 프리셋을 직접 호출할 수 있습니다.

4. API 배포 및 릴리즈 FAQ​

Q: API 배포 후 프리셋 변경이 반영되지 않는 이유는?​

A: API 배포는 특정 시점의 프리셋을 기반으로 설정됩니다. 최신 변경 사항을 반영하려면 새로운 배포를 수행해야 합니다.

Q: 서비스 장애 발생 시 어떻게 롤백할 수 있나요?​

A: 배포 내역에서 원하는 이전 버전을 선택하고 "최신 버전으로 설정" 버튼을 클릭하면 즉시 롤백됩니다.

Q: API를 완전히 비활성화하려면 어떻게 하나요?​

A: 배포된 API 상세 정보에서 "서비스 중단" 버튼을 클릭하면 더 이상 API 호출이 불가능합니다.

고객 지원 문의하기

이제 LaaS의 API 배포 및 릴리즈 기능을 활용하여 안정적인 서비스 운영을 시작하세요! 🚀

image-20241104-070152.png