跳转到主要内容

接口说明

为了方便开发者调用不同的视频生成模型,AIHubMix 提供了统一的视频接口,支持以下多种主流模型:
  • Google Veo 系列
  • OpenAI 系列
  • 万相(Wan)系列
接口规格:
curl -X POST "https://aihubmix.com/v1/videos" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "<model_path>",
    "prompt": "your prompt"
  }'
其中:

支持的参数

prompt
String
required
提示词。需要使用自然语言描述镜头,包括镜头类型、主体、动作、场景、光线以及任何所需的镜头运动,以减少歧义。为确保最佳效果,请保持描述内容单一。
model
String
模型。支持 veo-3.1-generate-preview,veo-3.0-generate-preview,sora-2,sora-2-pro,wan2.2-i2v-plus,wan2.2-t2v-plus,wan2.5-i2v-preview,wan2.5-t2v-preview。
size
String
尺寸(图像分辨率,宽度x高度),可以通过调整该参数修改生成视频比例。
  • sora 系列支持:720×1280(默认)、1280×720
  • veo 系列支持:720P(默认),1080P
  • wan 系列支持:480P(832x480、480x832、624x624),720P(1088x832、832x1088、960x960、1280x720、720x1280)和 1080P(1248x1632、1632x1248、1440x1440、1080x1920、1920x1080)。
seconds
String
生成视频长度。
  • sora 系列支持:4s(默认),8s,12s
  • veo 系列支持:4s,6s,8s(默认)
  • wan 系列支持:5s,10s(仅 wan2.5-t2v-preview 支持)
input_reference
File
参考图像,用于引导视频生成,该图像将作为视频的第一帧。支持的文件格式包括image/jpeg image/pbg image/webp
更多细节可以参考:Sora 2 API Reference

调用方法

默认生成(无引导图片)

curl -X POST "https://aihubmix.com/v1/videos" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "sora-2-pro",
    "prompt": "A astronaut floating in space, holding a glowing plant, with Earth and stars in the background, slow-motion movement",
    "size": "720x1280",
    "seconds": "4"
  }'

使用引导图片

curl --location --request POST 'https://aihubmix.com/v1/videos' \
--header 'Authorization: Bearer sk-***' \
--form 'prompt="The kitten is taking a nap under the tree."' \
--form 'model="sora-2"' \
--form 'size="1280x720"' \
--form 'seconds="4"' \
--form 'input_reference=@"xxx=/cat.jpeg"'

下载 MP4 文件


curl -L "https://aihubmix.com/v1/videos/{video_id}/content" \
  -H "Authorization: Bearer sk-***" \
  --output video.mp4

下载略缩图和精灵图

# 下载略缩图
curl -L "https://aihubmix.com/v1/videos/{video_id}/content?variant=thumbnail" \
  -H "Authorization: Bearer sk-***" \
  --output thumbnail.webp

# 下载精灵图
curl -L "https://aihubmix.com/v1/videos/{video_id}/content?variant=spritesheet" \
  -H "Authorization: Bearer sk-***" \
  --output spritesheet.jpg