kling-v1-6
kling-v1-6 프로필은 텍스트로 작성한 장면 설명을 바탕으로 동영상을 생성합니다. 문서에 나온 오 초 또는 십 초 길이 선택지를 사용해 피사체, 동작, 카메라 방향이 명확한 짧은 숏을 계획하세요. 생성은 비동기식입니다. 반환된 작업 식별 정보를 보관하고 원래 작업이 성공한 뒤 완성된 동영상을 가져오세요.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
정확한 선택자 kling-v1-6은 Kling 텍스트 동영상 생성 프로필을 식별합니다. model을 kling-v1-6로 설정하고 prompt에 텍스트로 작성한 장면 설명을 넣어 POST /v1/videos/generations에 JSON을 제출하세요. POST /v1/videos도 같은 생성 요청을 받습니다. 명확한 요청은 무엇이 보이는지, 숏 중에 무슨 일이 일어나는지, 카메라가 이를 어떻게 관찰하는지 설명합니다. 최소 장면 요청에는 모델 선택자와 prompt를 제공하고 추가 숏 제어는 지정하지 않습니다.
제품 숏에서는 물체, 표면, 조명, 느린 회전이나 카메라 위치 변경 같은 눈에 보이는 동작 하나를 설명하세요. 장면 콘셉트에서는 배경, 주요 피사체, 프레임 안에서의 움직임을 지정하세요. 요청한 클립 안에서 동작을 알아볼 수 있게 하세요. 예를 들어 잔잔한 호수를 가로지르는 작은 배, 호숫가에서 바라보는 넓은 시야, 이른 아침 빛, 배의 방향을 따라가는 안정된 카메라를 프롬프트에 설명할 수 있습니다.
prompt 한도는 500자입니다. 선택 항목인 negative_prompt는 최대 200자까지 가능하며 원하지 않는 요소를 설명합니다. 이 프로필의 문서상 duration 선택지는 5초와 10초입니다. mode 값은 std와 pro입니다. cfg_scale은 0에서 1 사이의 숫자이며, 문서는 값이 높을수록 텍스트를 더 강하게 따른다고 설명합니다. 정확한 숏에 맞는 제어 항목을 선택하고 제출한 값을 결과와 함께 보관하세요.
문서의 camera_control 객체에는 simple, down_back, forward_up, right_turn_forward, left_turn_forward 카메라 유형이 나옵니다. simple 설정에는 horizontal, vertical, pan, tilt, roll, zoom 제어가 명시되어 있습니다. 별도의 카메라 제어 객체 없이 장면을 설명할 수 있다면 최소 텍스트 예제가 유용한 출발점입니다. 피사체를 드러내거나 움직임을 따라가는 등 카메라 이동의 목적을 프롬프트에 명확히 제시하세요.
제출하면 비동기 작업이 시작됩니다. 반환된 id, X-Ailoot-Task-Id 헤더, polling_url을 보관한 뒤 같은 Ailoot API 키로 해당 polling_url에 GET을 보내 원래 작업을 읽으세요. 작업 상태는 data.task_status에 있습니다. submitted와 processing은 대기 중, succeed는 성공, failed는 실패를 나타냅니다. 따라서 제출 확인은 중간 결과입니다. 성공하면 data.task_result.videos[].url의 모든 URL에서 파일을 가져오세요. 이는 Ailoot가 관리하는 결과 파일 링크입니다. GET /v1/videos/{id}/content는 첫 번째 출력을 가져오며, index 쿼리 매개변수는 영부터 시작하는 인덱스로 반환된 출력을 선택합니다. 상태 응답을 선택한 클립과 함께 보관하세요. 시간 초과 또는 result_pending_check 응답이 발생하면 원래 반환된 식별 정보를 보관하고, 숏을 다시 제출하는 대신 해당 작업을 확인하세요.
완성된 영상을 전체 길이에 걸쳐 검토하세요. 의도한 동작, 피사체 외관, 프레이밍, 움직임은 모두 숏 작업 지시에 포함됩니다. 이 정확한 프로필은 여기에 설명된 텍스트 동영상 생성 작업 흐름을 제공합니다. 클라이언트 요청이 시간 초과되었을 때를 포함해, 반환된 작업에 상태 확인이 더 필요하다면 원래 식별 정보로 계속 확인해야 합니다. 새 생성 요청을 고려하기 전에 그 작업 정보를 보관하세요.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6시작하기
kling-v1-6 프로필은 텍스트로 작성한 장면 설명을 바탕으로 동영상을 생성합니다. 문서에 나온 오 초 또는 십 초 길이 선택지를 사용해 피사체, 동작, 카메라 방향이 명확한 짧은 숏을 계획하세요. 생성은 비동기식입니다. 반환된 작업 식별 정보를 보관하고 원래 작업이 성공한 뒤 완성된 동영상을 가져오세요.
- 허용 입력
- 텍스트
- 결과
- 동영상
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Video POST /v1/videos
- 입력
text- 출력
video
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 kling-v1-6 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드mode | 유형string | 요건필수 | 값과 한도 std, pro | 기본값— |
필드model_name | 유형string | 요건선택 사항 | 값과 한도 kling-v1-6 | 기본값— |
필드cfg_scale | 유형number | 요건선택 사항 | 값과 한도 최솟값: 0 최댓값: 1 | 기본값— |
필드aspect_ratio | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드negative_prompt | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드duration | 유형integer | 요건선택 사항 | 값과 한도 5, 10 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt, mode |
매개변수optional | 명세model_name, cfg_scale, aspect_ratio, negative_prompt, duration |
매개변수material_types | 명세text |
매개변수conditions | 명세model selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
메서드 별칭: /v1/videos/generations
수명 주기: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정Estimated generation cost | 요금표— | 예측 수량1회 생성 예상치 | 요금 입력 · 예상 생성 비용 · 비교 전용 추정치 $6 생성 전 추정치 This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
결과 수신 및 저장
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.
Retain the complete response, all actual results, original identifiers, usage and response headers.
원래 응답을 확인해야 할 경우
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
응답 필드
| 필드 | 유형 |
|---|---|
필드data.task_result.videos[].url | 유형string or array, as returned |
별칭
모델 별칭
Ailoot Ultra kling-v1-6
메서드 경로 별칭
/v1/videos/generations
관련 호출용 ID
FAQ · kling-v1-6
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/videos·kling-v1-6:text→video- 요청은 어떤 필드를 사용하나요?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- 어떤 제한이 적용되나요?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1