> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/ja/rissu/faq.md).

# FAQ

## Squish は音声を使用しますか？

CLI とローカル MCP サーバー（0.3 以降）は、低レートの音声アクティビティのエンベロープを抽出し、フレームと同じ絶対タイムラインに合わせます。これにより *〜するとき* エネルギーの変化 — 画像がほとんど変わらないときに有用です — を把握できますが、音声の再生、文字起こし、分類、解釈は行いません。レベルには 1 つの `clip_peak` スケールを使うため、ズームした区間も含めて元ソース全体で静かなウィンドウと大きなウィンドウを比較できます。音声トラックのない動画でも動作します。

Web アプリ、Hosted API、リモート MCP は、別途リリースされるまで視覚のみのままです。会話や「その音の原因は何ですか？」には、引き続き文字起こしや音声対応モデルが必要です。

それらのツールはうまく組み合わせられます。Squish のタイムコードは元動画に対して絶対で、文字起こしにも同じ時間軸のタイムスタンプが付くため、コンタクトシートと文字起こしはセルごとに対応し、両方を与えられたモデルは発話内容と見えていたものを結び付けられます。

## なぜ単に動画をモデルにアップロードしないのですか？

場合によってはそうすべきです。ただし、多くのモデルやプランは画像のみ対応で、動画のアップロードは遅くトークン消費も大きく、モデルが実際に「見た」ものを確認できません。コンタクトシートはコンパクトで、 **あらゆる** 画像モデル（LM Studio や Ollama のローカルモデルを含む）に対応し、検証可能です — モデルが見るフレームをそのまま確認できます — さらに、チャット、ドキュメント、バグ報告などどこにでも貼り付けられます。〜をご覧ください [アドレス空間としての動画](/squish/ja/purimitibu/video-as-address-space.md) より根本的な理由は、多くの質問がタイムラインのごく一部にしか関係しないため、再生するより移動して探すほうが速いからです。

## 料金はいくらですか？

このリポジトリ内のものはすべて無料です。CLI と MCP サーバーは、あらゆる密度で、アカウントもキーも不要で、完全にお使いのマシン上で動作します。これは試用ではなく、永続的な提供です。有料の方法は任意の [Hosted API](/squish/ja/hajimeni/quickstart-api.md) の `api.getsquish.app`のみです。これは、ローカル処理が選べない場合（CI、サーバーレス、ffmpeg がない環境）向けに前払いクレジットで動作します。購入履歴のないアカウントには、少額の無料日次枠があり、最初のリクエスト時に自動適用されます。

## Squish はオープンソースですか？

エンジンは Apache-2.0 で、 [`@getsquish/squish`](https://www.npmjs.com/package/@getsquish/squish) npm 上で公開されており、ソースは [github.com/getsquish/squish](https://github.com/getsquish/squish)にあります。このリポジトリは、プライベートなモノレポの厳選ミラーです（Web アプリと Hosted API はそちらにあります）。Issue と PR は公開リポジトリで歓迎します — 〜をご覧ください [貢献について](/squish/ja/rissu/contributing.md)。Squish の名称、ロゴ、マスコット、ブランド資産は保護されており、ライセンスの対象外です。

## どの動画形式に対応していますか？

お使いの ffmpeg がデコードできるものなら何でも対応します。CLI と MCP サーバーは、システム上の `ffmpeg`/`ffprobe`を呼び出すため、対応形式はローカル環境のビルドに完全に依存します。実際には MP4、MOV、WebM、MKV など、ほとんどすべてをカバーします。もし `ffprobe` ファイルから長さを読み取れるなら、Squish はシート化できます。

## タイムコードの精度はどの程度ですか？

最新の ffmpeg ではフレーム単位で正確です。エンジンは入力シーク（`-ss` の前に `-i`）を使用します。最寄りのキーフレームへジャンプし、その後、正確な目標時刻まで前方にデコードします。シークはミリ秒精度で実行され、付与されるラベルはウィンドウに応じて変化します — `m:ss` 通常は、ウィンドウが短い場合は秒未満（`1:07.3`）になります。さらに、隣接セルが必ず異なるアドレスを持つよう、1 セルあたり 2 ms を下限としています。重要なのは、タイムコードが **あらゆるズーム深度で元動画に対して絶対的**であることです。どのシートに記された値でも、ズームの深さに関係なく、元のファイル内の同じ瞬間を指します。

## シートや動画がマシンの外に出ることはありますか？

どの Squish を使っているかによります。率直に言うと、答えは一律の「いいえ」ではなく、用途ごとの違いがあります。

* **CLI / MCP サーバー（このリポジトリ）：** 何もマシンの外には出ません。フレームの抽出と合成はローカルで行われ、シートはディスクに保存されます。
* **Web アプリ（**[**getsquish.app**](https://getsquish.app)**):** 処理はブラウザ内で実行され、動画や写真はアップロードされません。
* **Hosted API（`api.getsquish.app`):** 唯一の意図的なアップロードです。動画を送信し、生成されたシートを一時リンク経由で受け取ります。

Hosted API が何をどのくらい保持するかを含む詳細は次のとおりです： [プライバシーとデータの流れ](/squish/ja/purimitibu/privacy-and-data-flow.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/ja/rissu/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
