Skip to main content

CLI 工具:通过 animal-gateway 调用 AI 图像/视频生成,以及本地图像处理能力

Project description

animal-mediakit

AI 图像/视频生成 + 本地图像处理 CLI 工具,通过 animal-gateway 统一调用多家 AI 供应商模型。

快速开始

cd extensions/animal-mediakit
uv sync
uv run animal-mediakit auth login
uv run animal-mediakit auth ping

供应商支持矩阵

能力 Gemini OpenAI Volcengine DashScope 腾讯云 VOD
生图 gemini-2.5-flash-image gpt-image-1.5 / azure/gpt-image-2 / tencent/gpt-image-2 Seedream 5.0 Wan 2.6 GEM/SI/Kling/Vidu/Jimeng/Hunyuan/Qwen/OG(gpt-image-2)
生视频 Veo 2.0 Sora 2 Seedance 2.0 Wan 2.6 T2V Kling/Vidu/Hailuo/Seedance/GV/OS
图生视频 - - - - Kling/Vidu/GV (首帧/参考)
图片编辑 - gpt-image-1.5 - - -
图片分析 Gemini Vision GPT-5 Vision - Qwen3-VL -
对口型 - - - - Kling (lip_sync)
数字人 - - - - Kling (avatar_i2v)
场景化生图 - - - - 电商场景
超分增强 - - - - ProcessMedia

CLI 命令参考

认证

animal-mediakit auth login              # SSO 登录
animal-mediakit auth logout             # 登出
animal-mediakit auth status             # 查看当前认证状态
animal-mediakit auth ping               # 测试 gateway 连通性

AI 图像生成

animal-mediakit generate image "prompt" -o out.png --model gemini/gemini-2.5-flash-image
animal-mediakit generate image "prompt" -o out.png --model openai/gpt-image-1.5
animal-mediakit generate image "prompt" -o out.png --model azure/gpt-image-2
animal-mediakit generate image "prompt" -o out.png --model tencent/gpt-image-2
animal-mediakit generate image "prompt" -o out.png --model doubao-seedream-5-0-260128
animal-mediakit generate image "prompt" -o out.png --model dashscope/wan2.6-image
animal-mediakit generate image "prompt" -o out.png --model vod/gem-3.1
animal-mediakit generate image "prompt" -o out.png --model vod/kling-3.0
animal-mediakit generate image "prompt" -o out.png --model vod/og-image2_low
animal-mediakit generate image "prompt" -o out.png --model vod/og-image2_high

AI 视频生成

animal-mediakit generate video "prompt" -o out.mp4 --model gemini/veo-2.0-generate-001
animal-mediakit generate video "prompt" -o out.mp4 --model openai/sora-2.0
animal-mediakit generate video "prompt" -o out.mp4 --model doubao-seedance-2-0-260128
animal-mediakit generate video "prompt" -o out.mp4 --model vod/kling-3.0 --duration 5
animal-mediakit generate video "prompt" -o out.mp4 --model vod/gv-3.1 --audio

VOD 高级场景

# 图生视频(首帧参考)
animal-mediakit generate video "prompt" -o out.mp4 --model vod/kling-3.0 --from-image ref.jpg

# 对口型
animal-mediakit generate lipsync --video input.mp4 --audio voice.mp3 -o out.mp4

# 数字人
animal-mediakit generate avatar --image person.png --audio speech.mp3 -o out.mp4

# 场景化生图(电商)
animal-mediakit generate scene-image "product on marble" --model vod/gem-3.0 -o out.png

# 超分增强
animal-mediakit enhance --file-id xxx -o enhanced.mp4

自定义主体

animal-mediakit element create --name "my-cat" --description "orange tabby" --image https://example.com/cat.jpg

图片编辑

animal-mediakit generate edit photo.jpg --prompt "把天空变成日落" -o edited.jpg
animal-mediakit generate edit photo.jpg --prompt "移除背景" -o edited.png --mask mask.png

图片分析

animal-mediakit analyze photo.jpg --prompt "描述这张图片"
animal-mediakit analyze photo.jpg --model openai/gpt-5 --prompt "这是什么品种的猫?"

本地图像处理

animal-mediakit image info photo.jpg
animal-mediakit image crop photo.jpg --rect 100,100,500,400 -o cropped.jpg
animal-mediakit image resize photo.jpg --width 800 -o resized.jpg
animal-mediakit image flip photo.jpg --direction horizontal -o flipped.jpg
animal-mediakit image rotate photo.jpg --angle 90 -o rotated.jpg
animal-mediakit image convert photo.jpg --format webp -o photo.webp
animal-mediakit image compress photo.jpg --quality 80 -o compressed.jpg

环境变量

变量 说明 默认值
MEDIAKIT_DEFAULT_IMAGE_MODEL 默认图像生成模型 gemini/gemini-2.5-flash-image
MEDIAKIT_DEFAULT_VIDEO_MODEL 默认视频生成模型 gemini/veo-2.0-generate-001
MEDIAKIT_HTTP_MAX_RETRIES HTTP 请求最大重试次数 3
MEDIAKIT_HTTP_RETRY_DELAY 重试基础延迟(秒) 2.0

测试

uv run pytest tests/ -x                          # 单元测试
uv run pytest tests/ -m integration -v -s        # 集成测试(需要有效凭证)

详细文档

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

animal_mediakit-1.2.38.tar.gz (26.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

animal_mediakit-1.2.38-py3-none-any.whl (36.5 kB view details)

Uploaded Python 3

File details

Details for the file animal_mediakit-1.2.38.tar.gz.

File metadata

  • Download URL: animal_mediakit-1.2.38.tar.gz
  • Upload date:
  • Size: 26.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for animal_mediakit-1.2.38.tar.gz
Algorithm Hash digest
SHA256 b5d37a512eedc25410482fd218583c58568cec96c798886bdaffb715b4e7d869
MD5 a8d1fe9949f81eef24d9df55d27281de
BLAKE2b-256 eae847f807b0ef3896d4e94e22b75cdbaad2dbd4da697af11a0b90b50d18796e

See more details on using hashes here.

File details

Details for the file animal_mediakit-1.2.38-py3-none-any.whl.

File metadata

  • Download URL: animal_mediakit-1.2.38-py3-none-any.whl
  • Upload date:
  • Size: 36.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for animal_mediakit-1.2.38-py3-none-any.whl
Algorithm Hash digest
SHA256 f57861889ff01ed609b39e1a0fff53b2fa6eff922a44ace20c0a570a094ee76e
MD5 874a7baf86d8c2854cc5b478726a9b5d
BLAKE2b-256 8def3528f5487c5efea399a99f8000465d8c3d67ccaf46a9a8362de4603703dd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page