프롬프트 기반 촬영 연출
텍스트로 영상을 생성하려면 피사체, 동작, 배경, 구도, 카메라 움직임을 설명합니다. 메인 프롬프트는 1~5,000자까지 입력할 수 있습니다. 단일 숏은 하나로 이어지는 동작에 집중합니다. 시점을 바꾸는 컷 전환이 필요하다면 숏을 나눠 각각 지정합니다.

이 모델에 적용되는 현재 BeatAPI 공개 소매 요금입니다.
| 모델 | 사양과 요금 | 요금 |
|---|---|---|
| Kling 3.0 | 8 sec · 720p Standard · no audio | $0.88 |
| Kling 3.0 | 8 sec · 1080p Pro · no audio | $1.04 |
| 텍스트로 영상 생성 | 메인 프롬프트에 피사체, 동작, 카메라 연출을 설명합니다. 텍스트만으로 단일 숏을 만들 때는 images와 multi_prompt를 생략하고 원하는 영상에 맞게 duration, aspect_ratio, sound를 설정합니다. |
|---|---|
| 시작 프레임 또는 시작·종료 프레임 | images에 공개 HTTPS 이미지 URL 1~2개를 시작·종료 순서로 입력합니다. 프롬프트에는 프레임 사이의 움직임을 설명합니다. 이미지 비율에 맞춰 생성하려면 aspect_ratio는 생략합니다. |
| 멀티 숏 | 전체 장면을 설명하는 프롬프트를 유지한 채 multi_shots를 켜고, multi_prompt 항목을 1~5개 추가합니다. 각 항목의 길이 합계는 duration과 같아야 합니다. 시작 이미지를 넣는다면 정확히 1장만 사용합니다. 이 모드에는 종료 프레임을 추가할 수 없습니다. |
하나로 이어지는 숏을 만들거나, 여러 숏의 길이를 정해 시퀀스를 구성합니다. 프레임 이미지로 구도를 정하고, 숏별 프롬프트와 사운드 설정으로 원하는 장면을 구체화합니다.
텍스트로 영상을 생성하려면 피사체, 동작, 배경, 구도, 카메라 움직임을 설명합니다. 메인 프롬프트는 1~5,000자까지 입력할 수 있습니다. 단일 숏은 하나로 이어지는 동작에 집중합니다. 시점을 바꾸는 컷 전환이 필요하다면 숏을 나눠 각각 지정합니다.
images에 HTTPS 이미지 1장을 넣으면 시작 프레임으로, 2장을 넣으면 시작·종료 프레임으로 사용합니다. 프롬프트에는 이미지의 구도를 바꾸는 지시 대신 프레임 사이의 움직임을 설명합니다. 이미지 비율에 맞춰 생성하려면 aspect_ratio는 생략합니다. 멀티 숏에서는 시작 이미지 1장만 사용할 수 있습니다.
multi_shots를 켜고 multi_prompt에 숏을 1~5개 정의합니다. 각 숏의 prompt는 최대 500자이며, duration은 1~12초의 정수로 지정합니다. 숏 길이의 합계는 작업 전체의 duration과 같아야 하며, 전체 길이는 3~15초입니다. 예를 들어 제품을 가까이 보여 주는 숏과 전체를 보여 주는 숏을 하나의 작업으로 만들면서 각 숏의 시간을 조절할 수 있습니다.
sound를 켜면 영상에 맞는 오디오를 함께 생성합니다. 숏 설명에 원하는 대사와 환경음을 적거나, 무음 영상을 만들려면 sound를 false로 설정합니다. 멀티 숏 모드의 기본값은 true이므로, 편집기에서 사운드트랙을 따로 넣을 예정이라면 false를 명시합니다.
새 영상 요청에 활용할 수 있는 프롬프트 예시입니다. API 입력 영역에서 예시에 맞게 duration과 sound를 설정합니다. 멀티 숏 요청에는 multi_prompt 항목도 별도로 입력해야 합니다.
텍스트 기반 생성: duration 5, aspect_ratio 16:9, resolution pro, sound false. 이미지 입력 없는 단일 연속 숏입니다.
밝은 회색 테이블 위에 브랜드 표시가 없는 무광 초록색 도자기 컵을 놓고 5초간 촬영합니다. 손잡이를 가까이서 보여 준 뒤 카메라가 천천히 옆으로 한 번 이동하며 컵의 테두리를 보여 줍니다. 왼쪽 창문에서 부드러운 빛이 들어오고 표면에는 은은한 반사광이 비칩니다. 배경은 차분하게 유지하고 컵은 움직이지 않습니다. 텍스트, 로고, 컷 전환, 사람은 넣지 않습니다.
텍스트 기반 스토리보드: duration 6, multi_shots true, sound false. 표면을 가까이 보여 주는 숏과 전체 모습을 보여 주는 숏을 각각 3초짜리 multi_prompt 항목으로 지정합니다. 아래 프롬프트는 두 숏에 공통으로 적용할 장면 설명으로 사용합니다.
옅은 회색 스튜디오 테이블 위에 브랜드 표시가 없는 브러시드 스틸 소재의 책상 조명을 놓고 두 숏으로 보여 줍니다. 두 숏에서 조명의 디자인, 왼쪽에서 비추는 부드러운 빛, 배경을 동일하게 유지합니다. 먼저 금속 표면과 연결 부위를 아주 가까이 보여 준 뒤, 조명 전체가 보이는 넓은 구도로 전환합니다. 텍스트, 사람, 다른 물체는 넣지 않습니다.
텍스트 기반 생성: duration 5, aspect_ratio 16:9, resolution pro, sound true. 화면에 보이는 동작 하나와 그에 맞는 환경음을 지정합니다.
조용한 목공 작업실 안을 5초간 미디엄 숏으로 촬영합니다. 장인 한 명이 작은 나무 상자를 작업대에 놓고 뚜껑을 한 번 닫습니다. 카메라는 고정하고 따뜻한 자연광 아래 손이 온전히 보이도록 합니다. 뚜껑이 닫힐 때 나무가 가볍게 부딪치는 소리와 잔잔한 작업실 환경음을 함께 생성합니다. 대사, 음악, 자막, 컷 전환은 넣지 않습니다.

A cinematic multi-shot sequence of a confident Y2K girl making an epic entrance to an exclusive rooftop party at night. Shot 1: 00:00 - 00:03 Wide shot of a luxury building entrance at night, with velvet ropes, security, flashing lights, stylish guests, and the rooftop party atmosphere glowing above the city. Shot 2: 00:03 - 00:06 A sleek silver car arrives and stops. The girl steps out wearing a bold pink Y2K outfit, tinted sunglasses, glossy makeup, and hoop earrings, instantly drawing attention. Shot 3: 00:06 - 00:09 Low-angle tracking shot as she walks toward the entrance with confidence, security opening the way while people turn to look and camera flashes pop around her. Shot 4: 00:09 - 00:12 Close-up beauty shot of her face, sunglasses, lip gloss, accessories, and confident expression as she continues forward through the glamorous nightlife scene. Shot 5: 00:12 - 00:15 Final hero shot as she enters the rooftop party, removes her sunglasses, and reveals a confident smile while the city lights and stylish crowd glow around her. Cinematic, stylish, Y2K fashion, luxury nightlife, premium lighting, glamorous energy, realistic motion, high detail

Superbike ride across a dramatic coastal highway (single continuous shot) From high above towering sea cliffs, the camera dives toward a superbike leaning into a series of ocean-side curves. Lock-on: the rider carving perfect racing lines with absolute control. The camera slingshots ahead, whips backward, then drops just above the rear wheel: chain spinning at full speed, knee skimming the asphalt, ocean spray exploding across the cliffs below. A tunnel emerges from solid rock; the rider blasts through darkness before exploding back into sunlight, skimming beneath cliff overhangs and crossing a towering suspension bridge above crashing waves. The camera never breaks away before blasting skyward into a breathtaking reveal of an endless coastline stretching toward the horizon beneath golden sunset light.
사전 승인된 제품 구도, 정해진 시점에 제품 전체를 보여 주는 장면, 장면 전환, 사운드가 있는 장면 등 필요한 결과물에 맞춰 촬영 내용을 정합니다. 생성된 영상은 최종 편집에 넣기 전에 검토합니다.
6초 영상을 소재를 가까이 보여 주는 3초 숏과 제품 전체를 보여 주는 3초 숏으로 나눕니다. multi_prompt 항목마다 카메라 각도를 지정하고, 메인 프롬프트에는 공통으로 유지할 제품과 조명을 설명합니다. 완성된 짧은 시퀀스에서 숏이 자연스럽게 이어지는지, 제품 형태와 컷 전환에 문제가 없는지 확인합니다.
사용이 승인된 제품 사진을 시작 프레임으로 삼아, 카메라가 제품 주위를 돌거나 천천히 다가가는 5초 영상을 만듭니다. 움직임은 카메라 이동과 미세한 반사광 변화로 제한합니다. 라벨의 글자가 잘 보이는지, 제품 윤곽이 유지되는지, 카메라 이동으로 드러난 부분에 실제로 없는 디테일이 생기지 않았는지 확인한 뒤 제품 영상 편집에 활용합니다.
보유한 스토리보드 이미지 2장으로 단일 숏의 시작·종료 구도를 정합니다. 프롬프트에는 두 프레임 사이에서 피사체나 카메라가 어떻게 움직일지 설명합니다. 편집 전에 전환 장면을 미리 확인하고, 중간 프레임에서 형태가 갑자기 변하지 않는지 검토합니다. 이미지 2장을 쓰는 이 요청은 멀티 숏 모드와 함께 사용하지 않습니다.
텍스트로 9:16 화면에 피사체 하나를 배치하고, 사람이 작업실 문을 여는 것처럼 명확한 시작 동작을 지정합니다. 생성된 짧은 숏은 소셜 영상의 도입부로 활용할 수 있습니다. 얼굴과 손의 움직임을 확인하고 주요 동작이 세로 화면을 벗어나지 않도록 합니다. 최종 자막은 편집기에서 추가합니다.
sound를 켜고 등장인물별로 짧은 대사와 주변 소리를 지정합니다. 전체 10초를 두 숏으로 나눠 말하는 장면과 상대방의 반응 장면에 시간을 배분합니다. 생성된 영상과 오디오로 대화 장면의 동선과 구성을 미리 확인합니다. 실제 편집에 쓰기 전에는 말하는 인물, 입 움직임, 대사 사이의 쉼, 컷 전환을 검토합니다.
장소와 상황을 설명한 뒤, 공간 전체를 보여 주는 넓은 숏, 동작을 보여 주는 미디엄 숏, 세부를 가까이 보여 주는 삽입 숏으로 나눕니다. 15초 작업 안에서 각 숏의 길이를 정합니다. 숏 구분 없는 클립 하나 대신 편집자가 골라 쓸 수 있는 여러 숏을 만듭니다. 숏 사이에서 공간이 자연스럽게 이어지는지 확인한 뒤, 선택한 숏을 최종 타임라인에 맞게 자릅니다.
공개 사양을 비교하고 자체 작업에서 출력 품질을 평가합니다.
| 비교 항목 | Kling 3.0 | Seedance 2.5 | Gemini Omni 1.1 Flash |
|---|---|---|---|
| API | Kling 3.0 | Seedance 2.5 | Gemini Omni 1.1 Flash |
| 입력 | prompt · images · frames | prompt · images · frames · references | prompt · images · frames · references |
| 해상도 | std | pro | 480p | 720p | 1080p | 720p | 1080p | 4k |
| 필수 입력 | model · prompt | model · prompt | model · prompt |
| 요금 | $0.88 · 8 sec · 720p Standard · no audio | $0.774512 · 8 sec · 480p · no video input | $0.48 · 8 sec · 720p |
촬영 내용을 담아 비동기 영상 작업을 생성한 뒤, 완성된 영상을 애플리케이션으로 가져옵니다.
숏마다 길이를 정하거나 첫·마지막 프레임을 맞춰야 하는 짧은 영상에 적합합니다. 편집 계획에 맞춰 사운드를 넣거나 무음으로 만들 수 있습니다.
Kling 3.0은 3~15초 작업 안에서 숏을 1~5개 지정할 수 있습니다. BeatAPI의 multi_prompt로 숏마다 프롬프트와 길이를 설정하면, 제품 디테일을 보여 주는 장면과 전체 모습을 보여 주는 장면의 속도감을 계획할 수 있습니다.
Kling 3.0은 사운드가 있는 영상과 무음 영상을 생성할 수 있습니다. 대사와 환경음이 필요하면 sound=true, 나중에 따로 음악을 넣으려면 false를 사용합니다. 두 설정의 초당 단가는 같습니다.
BeatAPI 문서는 시작 프레임만 쓰는 요청, 시작·종료 프레임을 쓰는 요청, 멀티 숏 요청을 구분해 안내합니다. 영상 작업을 생성하면 상태 조회와 완성된 미디어 확인에 사용할 ID를 받습니다. 사용이 승인된 스토리보드 이미지로 영상을 만들고, 결과를 검토한 뒤 편집에 활용할 수 있습니다.
Kling 3.0은 텍스트나 이미지로 영상을 생성하는 Kuaishou의 모델입니다. 여러 숏으로 이야기를 구성하고 영상에 맞는 오디오도 함께 생성할 수 있습니다. BeatAPI의 비동기 영상 작업 API에서는 텍스트 프롬프트, 시작 프레임 또는 시작·종료 프레임, 숏별 길이를 지정한 멀티 숏 시퀀스를 사용할 수 있습니다. 영상 길이는 3~15초입니다. 작업을 생성하고 상태를 조회한 뒤 완성된 미디어 URL을 애플리케이션으로 가져옵니다.
움직임이 있는 제품 영상, 여러 숏으로 제품을 보여 주는 짧은 영상, 스토리보드 전환, 세로형 영상의 도입부, 사운드가 있는 장면 등을 만들 수 있습니다. 사용이 승인된 시작 구도를 유지하려면 시작 프레임을, 마지막 구도까지 정하려면 시작·종료 프레임 2장을 사용합니다. 카메라 각도를 바꾸려면 숏별 프롬프트를 지정합니다. 최종 편집에 넣기 전에 영상이 자연스럽게 이어지는지, 피사체의 세부 모습이 유지되는지 검토합니다.
multi_shots를 true로 설정하고 메인 프롬프트 외에 multi_prompt 항목을 1~5개 입력합니다. 각 항목의 prompt는 1~500자, duration은 1~12초의 정수로 지정합니다. 숏 길이의 합계를 전체 duration으로 설정하며, 이 값은 3~15초여야 합니다. 예를 들어 3초 숏 2개라면 duration을 6으로 설정합니다. 시작 프레임 이미지는 정확히 1장이 필요합니다. 텍스트만 사용하거나 프레임 이미지 2장을 사용하는 멀티 숏 요청은 지원하지 않습니다.
예. 단일 숏 요청에서는 images에 공개 HTTPS 이미지 URL 2개를 시작·종료 순서로 입력할 수 있습니다. URL을 1개만 넣으면 시작 프레임으로 사용합니다. 이미지 비율에 맞춰 생성하려면 aspect_ratio를 생략하고, prompt에는 두 프레임 사이의 동작을 설명합니다. 멀티 숏 모드에서는 시작 이미지 1장만 사용할 수 있으므로 이미지 2장을 담은 요청 본문을 그대로 재사용하면 안 됩니다.
duration은 3~15초의 정수로 지정하며 기본값은 5입니다. 텍스트로 생성할 때는 16:9, 9:16, 1:1을 지원하며 기본값은 16:9입니다. 이미지로 생성할 때는 이미지 비율을 따르도록 aspect_ratio를 생략합니다. 멀티 숏에서도 전체 길이는 3~15초입니다. 숏마다 15초를 지정하는 것이 아니라 이 범위 안에서 각 숏의 시간을 나눕니다.
영상에 맞는 사운드를 생성하려면 sound=true, 무음 영상은 false로 설정합니다. 사운드 기본값은 멀티 숏에서는 켜짐, 단일 숏에서는 꺼짐입니다. 대사와 환경음은 해당 숏의 프롬프트에 적습니다. 오디오는 영상 작업의 일부이며 별도의 오디오 전용 출력이 아닙니다. 사운드를 켜거나 꺼도 단가는 같습니다.
resolution은 720p에 std, 1080p에 pro를 사용하며 기본값은 pro입니다. 4K, 720p, 1080p를 매개변수 값으로 보내지 않습니다. Standard와 Pro의 초당 단가는 다르지만 사운드 설정에 따라 달라지지는 않습니다.
아닙니다. Kling 3.0과 Kling 3.0 Omni는 서로 다른 모델이며, Omni 편집 매개변수는 이 요청에 사용할 수 없습니다. Kling 3.0은 프롬프트, 프레임, 멀티 숏 기반 생성을 지원합니다. Motion Control은 캐릭터 이미지와 참조 영상을 사용해 움직임을 옮깁니다. Motion Control을 연동하기 전에 현재 모델 목록에서 사용 가능 여부를 확인하세요.
예상 요금은 선택한 해상도의 초당 단가 × 영상 길이입니다. 사운드가 있는 영상과 무음 영상의 단가는 같습니다. 8초 비교는 요금 예시이며 출력 길이가 고정된다는 뜻은 아닙니다. 최종 요금은 완료된 작업의 usage에서 확인할 수 있습니다.
서버에서 model을 kling-v3로 설정하고 prompt를 담아 Bearer 인증으로 POST https://api.beatapi.io/v1/videos/tasks 요청을 전송합니다. 작업 생성에 성공해도 응답으로 받는 것은 영상이 아니라 작업 정보입니다. data.id를 저장하고 GET /v1/tasks/{id}로 상태를 조회합니다. status가 succeeded이면 data.output.media에서 미디어 URL을 확인합니다. 영상을 중복 생성하지 않고 상태 조회를 재개할 수 있도록 작업 ID를 보관합니다.
queued나 processing 상태라면 저장한 작업 ID로 계속 조회합니다. 상태 조회가 끊겼다고 새 작업을 생성할 필요는 없습니다. 작업이 성공하거나 실패하면 조회를 중지합니다. 실패한 경우 data.error_code와 data.error_message를 확인하고, 재시도하기 전에 API 오류 정책을 따릅니다. 요청 전에는 숏 길이의 합계와 멀티 숏의 이미지 1장 제한을 확인합니다. 문제 해결에 사용할 작업 ID와 요청 ID도 보관합니다.
Kling 3.0 연동: BeatAPI 카탈로그의 다른 프로덕션용 API와 연결하세요.
무료 잔액으로 이용할 수 없습니다. 충전 후 이용할 수 있습니다.