동영상 생성

개요

Atlas Cloud는 통합 API를 통해 업계 최고의 AI 동영상 생성 모델에 접근할 수 있습니다. 텍스트 프롬프트, 이미지 또는 기존 동영상 클립으로 고품질 동영상을 생성하세요 — 단 한 번의 API 호출로 가능합니다.

지원 모델 유형

유형	설명	사용 사례
텍스트-투-비디오	텍스트 설명으로 동영상 생성	크리에이티브 콘텐츠, 마케팅, 프로토타이핑
이미지-투-비디오	정적 이미지를 동적 동영상으로 애니메이션화	제품 데모, 캐릭터 애니메이션, 씬 생성
비디오-투-비디오	기존 동영상 변환 및 향상	스타일 변환, 동영상 향상, 효과
오디오-투-비디오	오디오와 동기화된 동영상 생성	뮤직비디오, 팟캐스트 비주얼, 프레젠테이션

주요 모델

모델	제공업체	특징
Kling	KwaiVGI	정밀한 모션 제어를 갖춘 고품질 동영상 생성, 여러 버전 제공
Vidu	Vidu	시네마틱 품질의 차세대 동영상 AI
Seedance	ByteDance	고급 댄스 및 모션 동영상 생성
Wan	Alibaba	강력한 프롬프트 추종력을 갖춘 동영상 생성
Hailuo	MiniMax	다양한 스타일의 크리에이티브 동영상 생성
Veo	Google	Google의 최첨단 동영상 생성 모델
Luma	Luma AI	전문가급 AI 동영상 생성
PixVerse	PixVerse	다재다능한 동영상 생성 및 편집

모든 동영상 모델의 전체 목록과 사양은 모델 라이브러리를 방문하세요.

API 사용법

텍스트-투-비디오

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateVideo",
    headers={
        "Authorization": "Bearer your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "kling-v2.0",
        "prompt": "A rocket launching into space with dramatic lighting and smoke effects"
    }
)

prediction_id = response.json()["data"]["id"]
print(f"Task submitted. Prediction ID: {prediction_id}")

이미지-투-비디오

이미지-투-비디오 워크플로우에서는 먼저 미디어 업로드 엔드포인트를 사용하여 소스 이미지를 업로드한 다음, 반환된 URL을 동영상 생성 요청에 전달합니다:

import requests

# 1단계: 소스 이미지 업로드
upload_response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("source_image.jpg", "rb")}
)
image_url = upload_response.json().get("url")

# 2단계: 이미지로 동영상 생성
response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateVideo",
    headers={
        "Authorization": "Bearer your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "kling-v2.0",
        "prompt": "The person in the image starts walking forward",
        "image_url": image_url
    }
)

prediction_id = response.json()["data"]["id"]

생성 상태 확인

동영상 생성은 비동기적으로 처리됩니다. 예측 ID를 사용하여 결과를 폴링하세요:

import requests
import time

def get_result(prediction_id, api_key):
    while True:
        response = requests.get(
            f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}",
            headers={"Authorization": f"Bearer {api_key}"}
        )
        result = response.json()

        if result["data"]["status"] == "completed":
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(f"Generation failed: {result['data'].get('error')}")

        time.sleep(5)  # 5초마다 폴링

output = get_result(prediction_id, "your-api-key")
print(f"Video URL: {output}")

Node.js 예제

const response = await fetch(
  "https://api.atlascloud.ai/api/v1/model/generateVideo",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer your-api-key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "kling-v2.0",
      prompt: "A beautiful timelapse of clouds moving over a mountain range",
    }),
  }
);

const { data } = await response.json();
console.log(`Task submitted. Prediction ID: ${data.id}`);

모델 선택 팁

품질 vs 속도: 최신 모델 버전(예: Kling v3.0)은 일반적으로 더 나은 품질을 제공하지만 생성 시간이 더 길 수 있습니다
모션 제어: 일부 모델은 카메라 움직임과 피사체 모션에 대한 더 나은 제어를 제공합니다
스타일: 각 모델은 다른 스타일에 특화 — 포토리얼리스틱, 애니메이션, 시네마틱 등
해상도 및 길이: 각 모델의 상세 페이지에서 지원되는 해상도와 최대 동영상 길이를 확인하세요

모델 라이브러리에서 모델을 탐색하고 비교하세요. 각 모델 페이지에는 테스트를 위한 인터랙티브 플레이그라운드와 상세한 파라미터 문서가 포함되어 있습니다.

전체 API 사양은 API 레퍼런스를 참조하세요.

목차