메인 콘텐츠로 건너뛰기
POST
/
video
/
generations
비디오 작업 제출
curl --request POST \
  --url https://api.orcarouter.ai/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling/kling-v3-omni",
  "prompt": "<string>",
  "image": "<string>",
  "metadata": {}
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "model": "<string>",
  "progress": 50,
  "created_at": 123
}

인증

​
Authorization
string
header
필수

OrcaRouter API 키는 sk-orca-...처럼 보입니다. Authorization: Bearer sk-orca-... 헤더로 전달하세요.

본문

application/json

model 접두사에 맞는 변형 선택:

  • kling/... → Kling video request
  • byteplus/... → Seedance video request
​
model
enum<string>
필수

Kling 비디오 모델(kling/ 네임스페이스 접두사가 있는 고객 대상 이름). Kling이 실제로 제공하는 엔드포인트 (text2video / image2video / omni-video)는 선택한 모델 이름이 아니라 전달하는 메타데이터 필드로 결정되지만 — kling/kling-video-o1과 kling/kling-v3-omni만이 멀티소스 참조 필드(image_list / video_list)를 받음.

사용 가능한 옵션:
kling/kling-v2-master,
kling/kling-v2-1-master,
kling/kling-v2-5-turbo,
kling/kling-v2-6,
kling/kling-v3,
kling/kling-video-o1,
kling/kling-v3-omni
예시:

"kling/kling-v3-omni"

​
prompt
string
필수

필수. Kling은 빈 / 공백만의 프롬프트를 거부.

​
image
string

이미지-to-비디오를 위한 선택적 첫 프레임 이미지(URL 또는 base64 data URI). metadata.image_tail과 상호 정보적.

​
metadata
object

Kling이 존중하는 자유 형식 매개변수 백.

범용(모든 엔드포인트):

  • mode(string): std(720P) / pro(1080P) / 4k. 4k는 kling/kling-v3와 kling/kling-v3-omni에서만. 텍스트/이미지-to-비디오의 기본값은 std, Omni-Video의 기본값은 pro.
  • aspect_ratio(string): 16:9 / 9:16 / 1:1.
  • duration(string): 초 단위 길이, 기본값 "5". kling/kling-v3-omni와 kling/kling-v3는 "3"-"15"를 받음; v2 패밀리와 kling/kling-video-o1 은 "5" 또는 "10"을 받음.

텍스트-to-비디오와 이미지-to-비디오만(Omni-Video는 NOT):

  • negative_prompt(string): 피할 것. 최대 2500자.
  • cfg_scale(number): 범위 [0, 1], 기본값 0.5. 높을수록 엄격한 프롬프트 준수. v2.x 모델에서 지원되지 않음.
  • image_tail(string): 첫/마지막 프레임 이미지-to-비디오 를 위한 마지막 프레임 이미지.

멀티소스 참조(Omni 엔드포인트, kling/kling-video-o1 / kling/kling-v3-omni만):

  • image_list(array): [{image_url, type}] — 다중 이미지 참조. 프롬프트에서 <<<image_1>>> 등으로 이미지 참조.
  • video_list(array): [{video_url, refer_type, keep_original_sound}]. kling/kling-v3-omni에서 3-10s와 std/pro 모드(4K가 아님)로 제한.

고급 기능(모델 의존 — Capability Map 참조):

  • multi_shot(bool) + shot_type (customize / intelligence) + multi_prompt ([{index, prompt, duration}]): 멀티샷 모드. kling/kling-v3와 kling/kling-v3-omni에서 사용 가능.
  • sound(string): "on" / "off" — 네이티브 오디오. kling/kling-v3와 kling/kling-v3-omni(모든 모드)와 kling/kling-v2-6(pro 모드만)에서 사용 가능.
  • watermark_info(object): {enabled: bool}. 범용.

응답

200 - application/json

작업 승인됨(비동기 — /v1/video/generations/{task_id} 폴링)

OpenAI 스타일 제출 응답. POST /v1/video/generations(및 OpenAI 대칭 별칭 POST /v1/videos)가 반환.

​
id
string

작업 ID. task_id와 동일 값(레거시 클라이언트용으로 유지).

​
task_id
string
​
object
enum<string>
사용 가능한 옵션:
video
​
model
string

고객이 보낸 대로의 모델 이름(별칭 / 네임스페이스 접두사 유지, 업스트림 해결 이름이 아님).

​
status
enum<string>

성공적 제출 시 항상 queued.

사용 가능한 옵션:
queued
​
progress
integer
필수 범위: 0 <= x <= 100
​
created_at
integer

작업이 제출된 Unix 타임스탬프.