Node.JS에서 CSV를 JPG로 변환

Fri, 07 Aug 2026 08:43:57 +0000

표 형식 데이터에서 미리보기 이미지를 생성하는 것은 대시보드나 이메일 보고서를 만들 때 흔히 요구되는 작업입니다. GroupDocs.Conversion Cloud SDK for Node.js는 서버 측에서 CSV 파일을 고품질 JPG 이미지로 변환할 수 있는 강력한 API를 제공합니다. 이 문서에서는 라이브러리의 비동기 메서드를 사용하여 Node.JS에서 CSV를 JPG로 변환하는 방법을 배우고, 전체 코드 예제를 확인하며, 동등한 cURL 호출을 살펴보고, 출력물을 미세 조정하기 위한 구성 옵션을 알아봅니다.

Node.JS에서 CSV를 JPG로 변환 - 전체 코드 예제

이 예제에서는 라이브러리의 비동기 API를 사용하여 GroupDocs Cloud 스토리지에 저장된 CSV 파일을 JPG 이미지로 변환하는 방법을 보여줍니다.

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

// Replace with your actual GroupDocs Cloud credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

async function convertCsvToJpg() {
    // Initialize the Conversion API
    const convertApi = new ConvertApi(clientId, clientSecret);

// Source CSV file stored in GroupDocs Cloud storage
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.csv";

// Conversion options: CSV -> JPG
    const convertOptions = new ConvertOptions();
    convertOptions.fileInfo = fileInfo;
    convertOptions.format = "jpg";

// Conversion settings (output folder in storage)
    const convertSettings = new ConvertSettings();
    convertSettings.outputPath = "output_images";
    convertSettings.convertOptions = [convertOptions];

try {
        const result = await convertApi.convertDocument(convertSettings);
        console.log("Conversion completed. Generated files:");
        result.forEach(file => console.log(file.path));
    } catch (err) {
        console.error("Conversion failed:", err);
    }
}

convertCsvToJpg();

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로(input.csv, output_images 등)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하시기 바랍니다.

cURL 및 REST API를 사용한 CSV에서 JPG 변환

순수 REST 방식을 선호한다면, 동일한 변환을 일련의 cURL 명령으로 수행할 수 있습니다.

액세스 토큰 얻기 - 클라이언트 자격 증명으로 인증합니다.

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

소스 CSV 업로드 - 파일을 GroupDocs Cloud 스토리지에 배치합니다.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/your/input.csv"

변환 요청 - 대상 형식을 JPG로 지정합니다.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo":{"filePath":"input.csv"}}'

생성된 이미지(들) 다운로드 - 출력 폴더에서 파일을 가져옵니다.

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output_images/your_image.jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o your_image.jpg

이 명령은 코드를 작성하지 않고도 전체 CSV‑to‑JPG 워크플로를 보여줍니다. 자세한 내용은 공식 API 문서를 참조하십시오.