kie.ai API 사용법, API 키 발급부터 AI 영상 장면 생성까지

먼저 설치할 프로그램은 없습니다. kie.ai 계정과 API 키, 사용할 크레딧이 필요합니다.

kie.ai는 여러 회사의 이미지·영상 생성 AI를 API 하나로 쓰게 해 주는 서비스입니다. 서비스마다 따로 가입하고 결제하지 않아도 한 계정, 한 크레딧 잔액으로 여러 모델을 부를 수 있습니다.

비유하면 여러 AI 스튜디오를 한 창구에서 예약해 주는 대행사입니다. 우리는 "이런 장면을 이 스튜디오에서 찍어 주세요" 하고 접수만 하고, 촬영이 끝나면 결과물을 받아 옵니다.

이 수업에서 하는 일

수업 03:20~03:40에 kie.ai API로 광고 영상 장면을 만듭니다. 앞 시간에 만든 설명 영상에 소개용 장면을 생성해 붙이는 실습입니다.

직접 코드를 쓰지는 않습니다. Codex에게 원하는 장면을 설명하면 Codex가 kie.ai에 요청을 보내고 결과를 받아 옵니다. 우리가 할 일은 API 키를 안전하게 넘겨주는 것과, 결과물이 쓸 만한지 판단하는 것입니다.

준비하기

1) https://kie.ai 에서 회원가입을 합니다. 2) https://kie.ai/api-key 에서 API 키를 만듭니다. 3) 사용할 크레딧을 충전합니다. 모델마다 소모하는 크레딧이 다릅니다.

계정 제공 여부, 필요한 요금제와 비용 부담 방식은 교육 담당자의 사전 안내를 확인해 주세요. 회사 계정을 쓰는 경우 개인이 따로 충전하지 않아도 될 수 있습니다.

가격과 지원 모델은 자주 바뀌어서 이 글에 숫자를 적지 않습니다. 최신 가격은 https://kie.ai/pricing 에서 확인하세요. 작업마다 크레딧이 얼마나 쓰였는지는 https://kie.ai/logs 에서 볼 수 있습니다.

API 키는 비밀번호입니다

API 키는 내 계정의 크레딧을 쓸 수 있는 열쇠입니다. 누군가 이 키를 알면 내 크레딧으로 마음대로 생성 작업을 돌릴 수 있습니다.

화면 캡처, 화면 녹화, 채팅, 메일, 공유 문서에 API 키가 보이지 않게 하세요. 수업 계획서에서도 API 키가 보이는 화면은 실습 자료에서 빼라고 안내합니다. 실습 영상을 녹화하는 중이라면 키를 붙여 넣는 순간은 녹화를 잠시 멈춥니다.

키가 노출됐다고 생각되면 바로 API 키 페이지에서 그 키를 지우고 새로 발급합니다. 비밀번호를 바꾸는 것과 같습니다.

확인: 키를 환경변수로 넣기

AI에게 키를 대화창으로 보내지 않고 환경변수로 넘깁니다. 환경변수는 프로그램이 꺼내 쓸 수 있도록 컴퓨터에 이름을 붙여 맡겨 두는 값입니다.

PowerShell을 열고 다음을 입력합니다. 따옴표 안에는 내 API 키를 붙여 넣습니다.

$env:KIE_API_KEY = "여기에_내_API_키"

이 명령은 KIE_API_KEY 라는 이름으로 키를 지금 열린 PowerShell 창에만 맡겨 둡니다. 창을 닫으면 사라지고, 다른 창에서는 보이지 않습니다.

값이 들어갔는지는 글자 수로 확인합니다. 키 자체를 화면에 출력하지 않기 위해서입니다.

$env:KIE_API_KEY.Length

0이 아닌 숫자가 나오면 들어간 것입니다. 아무것도 나오지 않으면 다른 창에서 설정했거나 입력이 빠진 것입니다.

32

숫자는 키 길이에 따라 다릅니다. Codex가 이 값을 어떤 방식으로 읽게 할지는 수업에서 강사가 환경에 맞게 안내합니다.

처음 써 보기

kie.ai의 이미지·영상 생성은 비동기 작업입니다. 요청을 보내자마자 결과가 오지 않고, 접수번호를 먼저 받은 뒤 완성되면 결과를 가져옵니다. 흐름은 다음과 같습니다.

1. 작업 만들기   장면 설명과 모델을 보내면 접수번호(taskId)를 받음
2. 기다리기      몇 분 걸릴 수 있음. 접수번호로 진행 상태를 확인
3. 결과 받기     완성되면 결과 파일 주소가 나옴. 바로 내려받기

공식 빠른 시작 문서 기준으로 작업 만들기는 https://api.kie.ai/api/v1/jobs/createTask , 상태 확인은 https://api.kie.ai/api/v1/jobs/recordInfo 주소를 씁니다. 모델마다 넣는 값이 다르고 일부 모델은 전용 주소를 쓰기도 해서, 세부 형식은 모델별 문서를 봅니다. 이 부분은 Codex가 문서를 읽고 처리합니다.

수업에서는 Codex에게 이렇게 요청합니다.

kie.ai API로 광고 영상의 첫 장면을 만들어 줘.
- API 키는 환경변수 KIE_API_KEY에 있어. 키 값을 화면에 출력하지 마.
- 장면: 밝은 사무실 책상 위 노트북 화면에 "설치 완료" 알림이 뜨는 모습, 5초, 가로 16:9
- 공식 문서 https://docs.kie.ai 를 확인해서 작업을 만들고, 완료될 때까지 상태를 확인해 줘.
- 완성되면 결과 파일을 output 폴더에 내려받고 파일 이름을 알려 줘.
- 쓴 모델과 소모 크레딧도 알려 줘.

결과가 나오면 앞에서 만든 영상에 붙여 봅니다. 장면이 제품 설명과 맞는지, 실제 화면과 다른 내용을 보여 주지 않는지 꼭 확인합니다. 생성 AI는 그럴듯하지만 틀린 화면을 만들 수 있습니다.

자주 막히는 곳

크레딧이 부족하면 작업이 만들어지지 않습니다. kie.ai는 오류가 나도 응답 안에 오류 코드와 메시지를 담아 돌려주므로, Codex에게 "응답에 담긴 오류 코드와 메시지를 보여 줘"라고 하면 원인을 확인할 수 있습니다. 잔액은 kie.ai 계정 화면에서 확인합니다.

생성이 오래 걸릴 수 있습니다. 영상은 몇 분 이상 걸리기도 하고, 이용자가 몰리면 더 늦어집니다. 수업 시간 안에 결과가 나오지 않으면 강사가 준비한 예제 결과로 편집 과정을 이어 갑니다.

결과 파일은 kie.ai에 영구 보관되지 않고 일정 기간이 지나면 자동으로 삭제됩니다. 결과 주소를 받으면 바로 내 컴퓨터에 내려받으세요. 보관 기간은 공식 문서에서 확인할 수 있습니다.

Codex가 키를 찾지 못한다고 하면 환경변수를 설정한 창과 Codex가 실행된 환경이 다를 가능성이 큽니다. 키를 대화창에 붙여 넣어 해결하지 말고 강사에게 알려 주세요.

회사 네트워크에서 외부 API 접속이 막혀 있을 수 있습니다. 수업 전에 교육 담당자에게 외부 API 접속이 가능한지 확인해 주세요.

용어 풀이

API: 프로그램끼리 정해진 형식으로 요청과 응답을 주고받는 창구입니다. API 키: API를 쓸 때 내가 누구인지 증명하는 비밀 문자열입니다. 비밀번호처럼 다룹니다. 크레딧: kie.ai에서 생성 작업에 쓰는 선불 포인트입니다. 비동기 작업: 요청 즉시 결과가 나오지 않고, 접수 후 기다렸다가 결과를 받는 방식입니다. 환경변수: 프로그램이 읽을 수 있도록 운영체제에 이름을 붙여 저장해 둔 값입니다.

맥에서는

계정, 키, 크레딧 준비는 같습니다. 환경변수를 넣는 명령만 다릅니다. 터미널 앱에서 다음을 입력합니다.

export KIE_API_KEY="여기에_내_API_키"

이 명령도 지금 열린 터미널 창에만 키를 맡겨 둡니다. 창을 닫으면 사라집니다.

다음 글

이 글이 시리즈의 마지막입니다. 다른 도구 글은 목록에서 수업 순서대로 볼 수 있습니다. 시리즈 전체 목록: https://www.letscoding.kr/blog/category/tools

공식 자료 https://kie.ai https://docs.kie.ai https://kie.ai/pricing

확인일: 2026-11-02