Gemini Omni 1.1 Flash API — Python 래퍼

Google Gemini Omni Flash on MuAPI를 위한 전용 Python SDK 및 MCP 서버입니다. text-to-video, image-to-video, video-edit, 재사용 가능한 음성 프로필, 재사용 가능한 캐릭터 프로필, 비동기 작업 폴링을 지원합니다.

Google은 2026년 8월 27일 Gemini Omni 1.1 Flash 업데이트를 발표했습니다 — 장면 확장(최대 10초의 분석된 컨텍스트, 최대 40초의 누적 길이), 첫 번째/마지막 프레임 키프레임 제어, 360p 초안 해상도 모드, 4K 업스케일링, 최대 3초의 비디오 참조 입력이 추가됩니다. 자세한 내용은 muapi.ai/gemini-omni-1.1-flash를 참조하세요. 이 클라이언트는 현재 MuAPI에서 제공되는 Gemini Omni Flash 엔드포인트를 래핑합니다. 위의 1.1 전용 컨트롤은 점진적으로 배포 중이며 아직 이 SDK에 노출되지 않았습니다 — MuAPI가 해당 기능을 추가하면 이 README와 코드가 업데이트됩니다.

관련 프로젝트

• Gemini Omni on MuAPI — 모델 랜딩 페이지: text-to-video, image-to-video, video-edit, 음성 프로필, 캐릭터 프로필.

• Gemini Omni 1.1 Flash on MuAPI — 1.1 업데이트의 새로운 기능과 배포 상태.

• gemini-omni-comfyui — MuAPI를 통한 Gemini Omni용 ComfyUI 커스텀 노드.

• Awesome-Gemini-Omni-API-Prompts — 엄선된 Gemini Omni 프롬프트 라이브러리 및 API 가이드.

• awesome-ai-video-models — API, 가격, 속도를 기준으로 AI 비디오 모델을 비교합니다.

• Wan-3.0-API — MuAPI를 통한 Wan 3.0 비디오 생성을 위한 Python SDK.

• Veo-4-API — Google Veo AI 비디오 생성을 위한 Python SDK.

• Seedance-2-API — ByteDance Seedance 비디오 생성을 위한 Python SDK.

• Generative-Media-Skills — 자동화된 미디어 워크플로를 위한 에이전트 지원 스킬.

• muapi-cli — MuAPI 이미지, 비디오, 오디오 모델에 대한 명령줄 액세스.

Related MCP server: PixVerse MCP

설치

git clone https://github.com/Anil-matcha/Gemini-Omni-1.1-Flash-API.git
cd Gemini-Omni-1.1-Flash-API
pip install -r requirements.txt
cp .env.example .env

.env에 MUAPI_API_KEY를 설정하세요. 기본 MuAPI 베이스 URL이 아닌 호환 가능한 제공업체를 사용하는 경우에만 GEMINI_OMNI_API_BASE_URL을 설정하세요.

빠른 시작

from gemini_omni_api import GeminiOmniAPI

api = GeminiOmniAPI()
job = api.text_to_video(
    "A street musician plays a violin on a rainy Paris evening, raindrops tap "
    "the cobblestones, a slow melancholic melody, distant café chatter.",
    duration=8,
    resolution="1080p",
    aspect_ratio="16:9",
)

result = api.wait_for_completion(job["request_id"])
print(result)

이미지를 비디오로

job = api.image_to_video(
    prompt="The subject slowly turns to face the camera as golden-hour light sweeps across the scene.",
    image_urls=["https://example.com/reference.jpg"],
    aspect_ratio="9:16",
    duration=8,
)

비디오 편집

job = api.video_edit(
    prompt="Restyle the entire clip as a hand-drawn Studio Ghibli animation, keep the original camera motion.",
    video_url="https://example.com/source.mp4",
    trim_start=0,
    trim_end=10,
    resolution="1080p",
)

음성 및 캐릭터 프로필

voice = api.create_audio_profile("Narrator", preset_voice="warm-male-1", style_description="calm, deliberate pacing")
character = api.create_character_profile("Host", image_url="https://example.com/host.jpg")

job = api.text_to_video(
    "The host welcomes viewers to the show.",
    audio_ids=[voice["audioId"]],
    character_ids=[character["characterId"]],
)

API 구성

text_to_video(), image_to_video(), video_edit()는 duration(4/6/8/10초), resolution(720p, 1080p, 4k), aspect_ratio(16:9, 9:16), 최대 3개의 audio_ids, 최대 3개의 character_ids, 그리고 seed를 허용합니다.

MCP 서버

MCP 지원 클라이언트에 Gemini Omni 도구를 노출합니다:

python mcp_server.py

서버는 text_to_video, image_to_video, video_edit, create_audio_profile, create_character_profile, get_task_status 도구를 제공합니다.

상태: 1.1 업데이트 배포 중

Google은 2026년 8월 27일 Gemini Omni 1.1 Flash를 발표했습니다. 현재 Google AI Studio, Gemini Enterprise Agent Platform, Google Flow, Gemini 앱을 통해 배포되고 있습니다. MuAPI는 새로운 1.1 컨트롤(장면 확장, 키프레임, 360p 초안 모드, 4K 업스케일링, 비디오 참조 입력)에 대한 API 액세스를 배포 중입니다 — 이 SDK는 현재 MuAPI에서 제공되는 Gemini Omni Flash 엔드포인트를 대상으로 하며, 1.1 엔드포인트가 출시되면 업데이트될 예정입니다.

엔드포인트 호환성

클라이언트는 GEMINI_OMNI_API_BASE_URL 아래의 gemini-omni-text-to-video, gemini-omni-image-to-video, gemini-omni-video-edit, gemini-omni-audio, gemini-omni-character 경로를 사용합니다. 제공업체가 엔드포인트를 다르게 명명하는 경우, 해당 제공업체의 호환 가능한 베이스 URL을 전달하거나 사용 전에 작은 클라이언트 모듈을 수정하세요.

라이선스

MIT