curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash-preview-official",
"prompt": "A red paper boat floating on a calm lake at sunrise",
"duration": 3,
"aspect_ratio": "16:9",
"resolution": "360p"
}'
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-1.1-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}
Gemini Omni Official
Gemini Omni 1.1 동영상 생성 및 편집
공식 Gemini Omni 1.1 Flash Preview로 3-10초 동영상을 4가지 해상도로 생성, 편집, 연장
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash-preview-official",
"prompt": "A red paper boat floating on a calm lake at sunrise",
"duration": 3,
"aspect_ratio": "16:9",
"resolution": "360p"
}'
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-1.1-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}
model을gemini-omni-1.1-flash-preview-official로 지정합니다- 텍스트→동영상, 이미지→동영상, 참조 동영상 생성, 동영상 편집, 동영상 연장을 지원합니다
- 참조 이미지 최대 10장과 입력 동영상 최대 3개; 이미지와 동영상은 하나의 요청에서 함께 사용할 수 있습니다
- 길이 3-10초; 해상도 360p / 720p / 1080p / 4K
- 비동기 태스크 API이며 제출 후 태스크 ID로 결과를 조회합니다
중국 본토 사용자는 예시 도메인을
https://toapis.cn으로 바꿀 수 있습니다.로컬 이미지는 이미지 업로드 API, 로컬 동영상은 동영상 업로드 API로 먼저 업로드한 뒤 반환된 URL을 전달하세요. base64 미디어 데이터를 직접 보내지 마세요.
Authorizations
string
필수
Bearer Token 인증을 사용합니다:
Authorization: Bearer YOUR_API_KEY
Body
string
기본값:"gemini-omni-1.1-flash-preview-official"
필수
모델 이름.
gemini-omni-1.1-flash-preview-official을 사용합니다.string
필수
생성, 편집 또는 연장할 동영상 프롬프트.
integer
기본값:"6"
동영상 길이(초),
3-10 정수. extend 태스크에서는 연장 길이를 의미하며 생략 시 약 10초입니다.string
기본값:"16:9"
화면 비율:
16:9가로9:16세로
edit 및 extend 태스크에서는 전송하지 않습니다.string
기본값:"720p"
동영상 해상도:
360p720p1080p4K
string[]
참조 이미지 URL 배열, 최대
10장. 생략하면 텍스트→동영상입니다. video_list와 함께 사용할 수 있습니다(예: 동영상을 연장할 때 참조 이미지 첨부).object[]
입력 동영상, 최대
3개. 각 항목에 video_url이 필요합니다. 예: { "video_url": "https://example.com/input.mp4" }. HTTPS URL, data URI, 플랫폼 업로드 동영상 URL을 지원하며 다운로드되는 입력 동영상은 개당 최대 50 MB, MP4/MOV입니다. image_urls와 함께 사용할 수 있어 동영상과 참조 이미지의 혼합 입력을 지원합니다. edit 및 extend 태스크에는 필수입니다.object
선택적 Interactions 생성 파라미터.
temperature(0.0–2.0), topP / top_p(0.0–1.0), candidateCount / candidate_count, previous_interaction_id, task(text_to_video, image_to_video, reference_to_video, edit, extend)를 지원합니다. task를 생략하면 플랫폼이 기본값을 넣지 않고 업스트림 모델이 프롬프트와 미디어로 추론합니다. edit와 extend(또는 입력 동영상이 있고 다른 태스크 미지정) 경로에서는 aspect_ratio를 생략합니다. extend는 video_list로 입력한 원본 동영상을 이어서 촬영하며 previous_interaction_id와 함께 사용할 수 없습니다.generateAudio, negativePrompt, seed 등 Veo 전용 파라미터는 지원하지 않습니다.
Response
string
상태 조회에 사용하는 태스크 ID.
string
객체 유형. 일반적으로
generation.task입니다.string
사용된 모델 이름.
string
태스크 상태:
queued, in_progress, completed, failed.integer
태스크 생성 타임스탬프.
string
태스크 완료 후 생성된 동영상 URL.
Examples
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash-preview-official",
"prompt": "A red paper boat floating on a calm lake at sunrise",
"duration": 3,
"aspect_ratio": "16:9",
"resolution": "360p"
}'
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash-preview-official",
"prompt": "Change the sky to a warm sunset",
"duration": 6,
"resolution": "1080p",
"video_list": [{"video_url": "https://example.com/uploaded-video.mp4"}],
"metadata": {"task": "edit"}
}'
duration은 연장 길이(초)이며 생략 시 약 10초. 출력은 원본에 연장분을 이어붙인 영상입니다):
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash-preview-official",
"prompt": "Continue the scene: the subject keeps moving naturally",
"duration": 5,
"video_list": [{"video_url": "https://example.com/uploaded-video.mp4"}],
"metadata": {"task": "extend"}
}'
{
"id": "video_01JZEXAMPLE",
"object": "generation.task",
"model": "gemini-omni-1.1-flash-preview-official",
"status": "queued",
"created_at": 1779247407
}
태스크 조회
제출 응답은 태스크 ID를 반환합니다. 공용 동영상 태스크 조회 엔드포인트로 상태와 결과를 가져오세요:curl --request GET \
--url https://toapis.com/v1/videos/generations/{task_id} \
--header "Authorization: Bearer YOUR_API_KEY"