動画入力実装ガイド - SambaNova ドキュメント

SambaNova は、SambaCloud と SambaStack 1.2 の両方で、一部のマルチモーダルモデルにおける動画入力に対応しており、テキストプロンプトと一緒に動画ファイルを渡すことができます。本ページでは、SambaNova または OpenAI の Python クライアントを使用して、SambaNova の動画対応モデルにクエリを送信する方法を解説します。

動画入力は現在 gemma-4-31B-it で対応しています。このモデルは音声入力には対応していません。

動画は以下の要件を満たす必要があります。

最大再生時間: 60 秒
フレームレート: 2 fps
最大ファイルサイズ: 100 MB
再生時間メタデータ: 動画ファイルに読み取り可能な再生時間メタデータが含まれていること

必ず "type": "video_url" と、その中にネストした video_url オブジェクトを使用してください。"type": "video" は未対応であり、バリデーションエラーが発生します。

動画を使用したクエリの作成

動画リクエストはマルチモーダル入力フォーマットに従います。video_url コンテンツタイプを使用して、base64 エンコードされた文字列または URL として動画を渡します。

ステップ 1

新しい Python ファイルを作成し、以下のコードをコピーします。

from sambanova import SambaNova
import base64

client = SambaNova(
    base_url="your-sambanova-base-url",
    api_key="your-sambanova-api-key",
)

def encode_video(video_path):
    with open(video_path, "rb") as video_file:
        return base64.b64encode(video_file.read()).decode("utf-8")

video_path = "sample.mp4"
video_base64 = encode_video(video_path)

response = client.chat.completions.create(
    model="gemma-4-31B-it",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Describe what is happening in this video."},
                {
                    "type": "video_url",
                    "video_url": {"url": f"data:video/mp4;base64,{video_base64}"},
                },
            ],
        }
    ],
)

print(response.choices[0].message.content)

from openai import OpenAI
import base64

client = OpenAI(
    base_url="your-sambanova-base-url",
    api_key="your-sambanova-api-key",
)

def encode_video(video_path):
    with open(video_path, "rb") as video_file:
        return base64.b64encode(video_file.read()).decode("utf-8")

video_path = "sample.mp4"
video_base64 = encode_video(video_path)

response = client.chat.completions.create(
    model="gemma-4-31B-it",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Describe what is happening in this video."},
                {
                    "type": "video_url",
                    "video_url": {"url": f"data:video/mp4;base64,{video_base64}"},
                },
            ],
        }
    ],
)

print(response.choices[0].message.content)

ステップ 2

API キーと URL ページで取得した SambaNova API キーとベース URL で、"your-sambanova-api-key" と "your-sambanova-base-url" を置き換えます。

ステップ 3

"sample.mp4" を、お使いの動画ファイルのパスに置き換えます。

ステップ 4

content 配列内のプロンプトテキストを、ユースケースに合わせて変更します。

ステップ 5

Python ファイルを実行して、テキスト出力を受け取ります。

ペイロード形式

video_url コンテンツブロックには、base64 エンコードされた動画または URL のいずれかを指定できます。

{
  "type": "video_url",
  "video_url": {
    "url": "data:video/mp4;base64,<base64-encoded-video>"
  }
}

{
  "type": "video_url",
  "video_url": {
    "url": "https://example.com/sample.mp4"
  }
}

はじめに

モデル

機能一覧

活用ガイド

リソース

動画入力機能の実装

動画を使用したクエリの作成

ペイロード形式

​動画を使用したクエリの作成

​ペイロード形式

動画を使用したクエリの作成

ペイロード形式