Omni Flash API로 텍스트 프롬프트에서 비디오를 생성하는 방법 (Node.js 구현 가이드)

브라우저 기반 AI 비디오 생성 서비스 Omni Flash에는 개발자를 위한 REST API가 제공됩니다. 본 기사에서는 텍스트 프롬프트로부터 비디오를 생성하는 일련의 플로우(작업 생성 → 폴링 → 결과 가져오기)를 Node.js로 구현하는 방법을 설명합니다.

API 키는 공식 웹사이트 계정 페이지에서 발급받을 수 있습니다. Omni Flash에 로그인하여 계정 화면(omniflash.net/account)에서 API 키를 생성해 주세요. 발급되는 키는 sk-로 시작하는 문자열입니다.

모든 요청은 Bearer 토큰으로 전송해야 합니다.

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

• 베이스 URL:
  https://omniflash.net/api/v1
• 작업 생성:
  POST /api/v1/tasks/create
• 작업 조회:
  GET /api/v1/tasks/{task_id}

비디오/이미지 생성은 비동기 처리입니다. 먼저 작업을 생성하여 task_id를 받은 후, 해당 조회 엔드포인트를 주기적으로 호출하며 완료를 기다리는 흐름이 됩니다.

model_id	용도	출력
omni-flash	텍스트/이미지 → 비디오	video_url
...
이번에는 비디오 생성이므로 omni-flash를 사용합니다.

POST /api/v1/tasks/create에 다음 JSON을 전송합니다.

{
"model_id": "omni-flash",
"prompt": "a serene zen garden at sunrise, gentle camera pan",
...
}

aspect_ratio에는 가로형 16:9와 세로형 9:16을 지정할 수 있습니다. 이미지에서 비디오를 생성하고 싶다면 image_urls에 입력 이미지의 URL을 배열 형태로 전달합니다.

응답은 다음과 같은 형태입니다.

{
"code": 200,
"msg": "submission successful",
...}

크레딧은 전송 시점에서 차감됩니다. 추후 설명하겠지만, 작업이 실패한 경우에는 자동으로 반환됩니다.

GET /api/v1/tasks/{task_id}의 응답에 있는 task_status를 보고 완료 여부를 판단합니다.

task_status	상태
1	대기열 대기
...
3 (성공)이 되면 data.video_url에서 비디오를 가져올 수 있습니다.

Node.js 18 이상에서는 표준 fetch를 사용할 수 있습니다.

const BASE_URL = "https://omniflash.net/api/v1";
const API_KEY = process.env.OMNIFLASH_API_KEY;
const headers = {
... 

• code: 200 … 성공 -
• code: 0 … 비즈니스 로직 상의 실패. msg 필드에 원인이 담기므로 반드시 로그로 남겨야 함 -
• code: 401 … API 키가 유효하지 않거나 지정되지 않음

task_status가 4 (실패)가 된 경우, 소모된 크레딧은 자동으로 반환됩니다. 애플리케이션 측에서 재큐잉할 때는 이 동작을 고려하여, 이중 과금을 걱정하지 않고 그대로 리트라이해도 문제없습니다.

Omni Flash의 API는 '작업 생성 → 폴링 → URL 가져오기'라는 간단한 비동기 패턴으로 비디오 생성을 구현할 수 있습니다. 설치가 필요 없는 브라우저 기반 본체에 더해, 이러한 API가 존재함으로써 배치 처리나 자체 서비스에 통합하는 것이 용이합니다. 먼저 Omni Flash에 로그인하여 API 키를 발급받고, 위의 샘플을 실행해 보세요.