메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "코기 한 마리가 해변을 달린다, 영화 같은 느낌, 황혼의 빛",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "코기 한 마리가 해변을 달린다, 영화 같은 느낌, 황혼의 빛",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
인증

​
Authorization
string
필수
모든 API는 Bearer Token을 사용한 인증이 필요합니다API Key 발급:API Key 관리 페이지에 접속하여 API Key를 발급받으세요사용 시 요청 헤더에 다음을 추가합니다:
Authorization: Bearer YOUR_API_KEY

​
요청 파라미터

​
model
string
필수
비디오 생성 모델 이름지원되는 모델:
  • kling-3.0-turbo - Kling 3.0 Turbo
​
prompt
string
필수
텍스트 프롬프트업스트림 제한은 3072자 이하이며, 2500자 이하를 권장합니다.예시: "코기 한 마리가 해변을 달린다, 영화 같은 느낌, 황혼의 빛"
​
first_frame_image
string
이미지 URL 또는 Base64를 지원합니다.
첫 프레임 이미지 업스트림 제한:
  • 형식: .jpg / .jpeg / .png
  • 크기: ≤ 50MB
  • 너비/높이: ≥ 300px
  • 종횡비: 1:2.5 ~ 2.5:1
​
aspect_ratio
string
기본값:"16:9"
비디오 종횡비선택 가능한 값:
  • 16:9 - 가로 화면
  • 9:16 - 세로 화면
  • 1:1 - 정사각형
기본값: 16:9
텍스트-투-비디오에서만 적용됩니다. 이미지-투-비디오 시 이 필드는 무효이며, 비디오 비율은 첫 프레임 이미지로 결정됩니다.
​
resolution
string
기본값:"720p"
비디오 해상도선택 가능한 값:
  • 720p
  • 1080p
기본값: 720p
​
duration
integer
기본값:"5"
비디오 길이(초)값의 범위: 3-15(최소 3초, 최대 15초)기본값: 5⚠️ 주의: 반드시 순수 숫자를 입력해야 하며(예: 6), 따옴표를 붙이지 마세요. 그렇지 않으면 오류가 발생합니다
​
watermark
boolean
워터마크 추가 여부명시적으로 전달했을 때만 업스트림으로 전송되며, 전달하지 않으면 워터마크를 추가하지 않습니다.

​
텍스트-투-비디오 vs 이미지-투-비디오

시스템은 first_frame_image 제공 여부에 따라 생성 모드를 자동으로 판단합니다. 첫 프레임 이미지가 있으면 이미지-투-비디오, 없으면 텍스트-투-비디오로 처리되며, 사용자가 명시적으로 선언할 필요가 없습니다.
파라미터텍스트-투-비디오이미지-투-비디오
prompt✅ 필수✅ 선택(비워 두면 첫 프레임 이미지만으로 생성)
first_frame_image❌ 전달 안 함✅ 필수
aspect_ratio✅ 선택❌ 무효(비율은 첫 프레임 이미지로 결정)
resolution✅ 선택✅ 선택
duration✅ 선택(3-15)✅ 선택(3-15)
watermark✅ 선택✅ 선택

​
응답

​
code
integer
응답 상태 코드, 성공 시 200
​
data
array
반환 데이터 배열

​
사용 시나리오

​
시나리오 1: 텍스트-투-비디오(1080P)

{
  "model": "kling-3.0-turbo",
  "prompt": "코기 한 마리가 해변을 달린다, 영화 같은 느낌, 황혼의 빛",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

​
시나리오 2: 텍스트-투-비디오(세로 화면 720P)

{
  "model": "kling-3.0-turbo",
  "prompt": "도쿄 시부야 교차로, 비 내리는 밤 네온사인이 젖은 바닥에 비치고, 행인들이 우산을 쓰고 지나간다",
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 10
}

​
시나리오 3: 이미지-투-비디오(첫 프레임 이미지)

{
  "model": "kling-3.0-turbo",
  "prompt": "카메라가 천천히 다가가고, 인물이 미소 짓는다",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "720p",
  "duration": 5
}

​
시나리오 4: 첫 프레임 이미지만으로 비디오 생성(프롬프트 없이)

{
  "model": "kling-3.0-turbo",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "1080p",
  "duration": 5
}

​
시나리오 5: 멀티 샷 분할 화면(텍스트-투-비디오)

{
  "model": "kling-3.0-turbo",
  "prompt": "샷 1,2,해변에서 코기가 달린다；샷 2,3,카메라가 인물에게 다가가 미소 짓는다；",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}
작업 결과 조회비디오 생성은 비동기 작업으로, 제출 후 task_id를 반환합니다. 작업 상태 조회 API를 사용하여 생성 진행 상황과 결과를 조회하세요.