Gemini Omni 1.2 일반 | ToAPIs Documentation

POST

/v1/videos

일반 버전은 텍스트 및 이미지 기반 영상 생성, 4-15초 / 720p. 참조 이미지는 최대 5개, 처음/마지막 프레임 지정 지원.

플랫폼 API Key를 사용하세요. 중국 본토에서는 https://toapis.cn을 사용할 수 있습니다.

1.1 일반

요청 매개변수

Authorizationstring헤더필수

Bearer YOUR_API_KEY

modelstring본문필수

gemini-omni-1.2-flash-preview

promptstring본문필수

필수 동영상 설명.

durationinteger본문기본값: 10

영상 길이 4-15초, 미입력 시 10초.

resolutionstring본문기본값: 720p

720p

aspect_ratiostring본문기본값: 16:9

16:9 또는 9:16, 기본 16:9.

image_urlsstring[]본문

참조 이미지로 공개 이미지 URL 최대 5개.

first_image_urlstring본문

첫 프레임 이미지의 공개 URL.

last_image_urlstring본문

마지막 프레임 이미지의 공개 URL.

로컬 미디어는 먼저 업로드하여 공개 URL을 얻습니다. base64, data URI, 로컬 경로를 보내지 마세요. 동영상 입력은 지원하지 않습니다.

요청 예시

curl https://toapis.com/v1/videos \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-omni-1.2-flash-preview",
    "prompt": "A cinematic tracking shot through a sunlit city",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "image_urls": ["https://example.com/image.png"]
  }'

처음/마지막 프레임 예시

curl https://toapis.com/v1/videos \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-omni-1.2-flash-preview",
    "prompt": "Generate a video from the first and last frames",
    "duration": 6,
    "first_image_url": "https://example.com/first.png",
    "last_image_url": "https://example.com/last.png"
  }'

태스크 조회

제출하면 플랫폼 task id가 반환됩니다. GET /v1/videos/{id}로 폴링하고 완료되면 영상 결과를 확인합니다. 공급업체 task_id나 공급업체 조회 엔드포인트는 사용하지 마세요.

curl https://toapis.com/v1/videos/YOUR_TASK_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

응답 예시

{
  "id": "vid_example",
  "object": "generation.task",
  "model": "gemini-omni-1.2-flash-preview",
  "status": "queued",
  "created_at": 1789600000
}