비디오 생성

비디오 생성 작업을 제출하고 처리 상태와 생성 결과를 조회합니다.

개요

AGTCloud는 여러 비디오 생성 모델과 호출 프로토콜을 제공합니다. 비디오 요청은 일반적으로 먼저 작업을 생성한 후 작업 식별자로 상태를 조회하고 결과를 읽습니다.

지원하는 작업 유형

유형	설명	주요 입력
텍스트 기반 비디오 생성	텍스트 설명으로 비디오를 생성합니다	Prompt
이미지 기반 비디오 생성	정지 이미지에 움직임을 추가합니다	Prompt, 이미지
참조 자료 기반 생성	모델이 지원하는 이미지나 비디오 자료로 콘텐츠를 생성합니다	Prompt, 참조 자료
모델 전용 확장	시작·종료 프레임, 카메라 움직임 또는 기타 전용 기능을 사용합니다	해당 모델과 프로토콜을 기준으로 합니다

API 연동

Base URL

https://api.agtcloud.cn/v1

텍스트 기반 비디오 생성

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "비가 그친 계곡을 지나는 기차, 카메라가 천천히 앞으로 이동합니다"
  }'

이미지 기반 비디오 생성

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "대상의 외형을 유지하면서 화면 속 인물이 카메라를 향해 천천히 걸어오게 합니다",
    "image": "https://example.com/input.jpg"
  }'

생성이 성공하면 응답의 Task ID를 저장하고 동일한 프로토콜로 작업을 조회합니다.

작업 조회

curl 'https://api.agtcloud.cn/v1/video/generations/TASK_ID' \
  -H 'Authorization: Bearer your-api-key'

생성과 조회 필드는 각각 비디오 작업 생성과 비디오 작업 조회를 확인합니다.

호출 프로토콜 선택

프로토콜	생성 엔드포인트	후속 처리
Platform Video Generations	`POST /v1/video/generations`	Task ID로 결과를 조회합니다
OpenAI Videos	`POST /v1/videos`	Video ID로 조회하고 콘텐츠를 다운로드합니다
공급업체 전용 프로토콜	해당 레퍼런스를 기준으로 합니다	해당 프로토콜이 정의한 작업 식별자와 상태를 사용합니다

하나의 작업에서는 생성, 조회와 다운로드 경로에 항상 동일한 프로토콜을 사용해야 합니다.

개요