동영상 생성(비동기 작업)

Veo 3.1, Sora 2 Pro, Kling, Seedance, Runway, Wan, Hailuo 등으로 동영상을 생성합니다. 동영상 생성에는 수십 초에서 몇 분이 걸리므로 비동기 작업으로 실행됩니다. 작업을 만들고, 상태를 폴링한 다음, 결과를 내려받습니다.

작업 만들기

POST https://api14.com/api/v1/videos

모델별로 지원하는 길이, 해상도, 화면 비율은 GET /videos/models(공개) 또는 모델 페이지에서 확인하세요.

잔액 확인

작업을 제출하기 전에 게이트웨이는 요청한 해상도(및 오디오 옵션)의 초당 가격에 길이를 곱해 가격을 추정합니다. 잔액이 추정치보다 적으면 요청은 402 insufficient_balance로 실패하고 아무것도 시작되지 않습니다.

응답

{
  "id": "vid_01JABCDEF",
  "status": "queued",
  "polling_url": "/api/v1/videos/vid_01JABCDEF"
}

작업 폴링

GET https://api14.com/api/v1/videos/{id}

{
  "id": "vid_01JABCDEF",
  "status": "completed",
  "generation_id": "gen-1791100000-abc",
  "unsigned_urls": ["/api/v1/videos/vid_01JABCDEF/content?index=0"],
  "usage": { "cost": 1.2 }
}

5–10초마다 폴링하세요. 작업을 만든 계정만 조회할 수 있으며, 다른 ID는 404 not_found를 반환합니다.

결과 다운로드

GET https://api14.com/api/v1/videos/{id}/content?index=0

API 키로 동영상 바이트(보통 video/mp4)를 반환합니다. 출력 URL은 항상 게이트웨이를 가리키며 업스트림 제공자를 직접 가리키지 않습니다. 파일이 아직 준비되지 않았거나 만료되었다면 content_unavailable이 반환됩니다.

예제

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

// Video generation is asynchronous: submit, then poll until completed.
let job = await client.post("/videos", { body: {
  "model": "google/veo-3.1-fast",
  "prompt": "A drone shot over turquoise ocean waves at sunrise",
  "duration": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9"
} });
while (!["completed", "failed"].includes(job.status)) {
  await new Promise((r) => setTimeout(r, 5000));
  job = await client.get(`/videos/${job.id}`);
}
console.log(job.status, job.unsigned_urls);

과금

작업이 completed에 도달했을 때 제공자의 실제 비용으로 한 번만 과금됩니다. 실패, 취소, 만료된 작업은 무료입니다. 작업은 백그라운드에서도 완료되므로, 폴링하지 않은 작업도 정산되어 사용량에 표시됩니다.

오류

오류를 참고하세요.