> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/shiteappurdo/adding-data.md). # 画像、動画、アノテーションをアップロードする Roboflow でモデルを学習・デプロイする最初のステップは、Project にデータをアップロードすることです。 まず、 [Project を作成する](/datasets/ja/shiteappurdo/create-a-project.md). その後、データをアップロードできる Web ページに移動します。このページには、プロジェクトのサイドバーにある「Upload Data」ボタンからもアクセスできます。 ## データを追加する方法 Roboflow アカウントには、以下の方法でデータを追加できます： * Web アプリケーションを使用する：1,000 枚未満の画像を含むデータセットに推奨。 * コマンドラインを使用する：1,000 枚を超える画像を含むデータセットに推奨。 * Dataset Upload Workflow Block を使用する：本番運用中のモデルを含む Workflow からデータを収集する場合に推奨。 {% hint style="info" %} 画像がすでに AWS S3、Google Cloud Storage、Azure Blob Storage などのクラウドストレージにある場合は、 [Datasources](/datasets/ja/shiteappurdo/adding-data/datasources.md) を使い、アップロードをスクリプト化する代わりに Bucket Mirror を既定の方法として使用してください。Datasource は、Workspace 内に画像とメタデータを自動的に取り込み、処理し、同期します。署名付き URL のアップロードやローカルダウンロードは、一度限りのインポートや必要に応じたインポートにのみ使用してください。 {% endhint %} Web アプリケーションとコマンドラインから、次のものをアップロードできます： * JPG、PNG、WEBP、AVIF、BMP、HEIC/HEIF 画像。\* * MOV および MP4 動画。 * PDF ファイル。 * [対応形式のアノテーション。](https://roboflow.com/formats) \**最大サイズは 20MB、16,400 x 10,900 ピクセルです。* アノテーションは、関連する画像と一緒にしかアップロードできません。すでにデータセットに取り込まれている画像のアノテーションをアップロードすることはできません。 ## Web アプリ Project を作成するとき、または Upload Data ページで、画像、動画、アノテーションをドラッグ＆ドロップできるボックスが表示されます：
[40 種類以上のアノテーション形式がサポートされています。](https://roboflow.com/formats) サポートされる形式は、Project の種類によって異なります。
ファイル名の処理方法 画像ファイル名を標準化できるよう、アップロード／インポート時とエクスポート時の両方でクラス名をサニタイズします。アップロード時とデータセットのエクスポート時には、次の処理を行います： * 先頭と末尾の空白を削除 * すべての空白（改行やタブを含む）はスペースに変換されます * 連続した 2 つのスペースは削除されます * `/.[]#~*` 文字はダッシュ（`-`) * `|'"` 文字は削除されます
### Zip ファイルをアップロードする 次のいずれかの `.zip` 画像とアノテーションのアーカイブをドラッグ＆ドロップするか、選択できます。小さいアーカイブ（最大 300 ファイル）はブラウザ内で展開され、フォルダをドロップした場合と同じアップロードフローで処理されるため、サムネイルのプレビュー、アノテーションの照合、バッチ名の付け方も同じように動作します。アーカイブ内にネストされたフォルダは保持されます。 大きいアーカイブ（300 ファイル超、最大 8 GB）は、代わりに生の zip を Roboflow のサーバーへアップロードします。確認すると進行状況バーでアップロードが追跡され、その後はブラウザが処理を引き継ぎ、サーバー側で処理が続行されます。Activity Center で進行状況を確認できるので、作業を続けながら都合のよいタイミングで戻って確認できます。展開された画像は Annotate ページにバッチとして表示されます。 アーカイブにアノテーションが含まれている場合、その画像は 1 つのアノテーションジョブにまとめられ、あなたにクレジットされます。アップロードごとに個別のジョブが作成されるため、同じ zip を再アップロードしても以前のジョブが再利用されることはありません。 [Review Mode](/datasets/ja/anotshon/anotshon/team-collaboration.md#review-mode) をオンにすると、画像は Review に保留され、レビュアーが承認するとデータセットに追加されます。Review Mode をオフにすると、すぐにデータセットに追加されます。 8 GB を超えるアーカイブの場合は、zip を [コマンドラインで](#upload-datasets-with-the-command-line) アップロードしてください。 ### 動画をアップロード アップロードされた動画は、アノテーション可能な個々のフレームに分割されます。動画をアップロードすると、内蔵の動画プレーヤー、サンプリングスライダー、任意の手動フレーム選択を備えた抽出ダイアログが開きます。 #### サンプリング間隔 スライダーを使って、フレームをどの頻度でサンプリングするかを設定します。スライダー下の入力欄に、間隔を秒で入力するか、必要なフレーム数を直接入力することもできます。サンプリング範囲は、毎秒 60 フレームから 60 秒に 1 フレームまでです。 #### 手動フレーム選択 「Manual selection」をクリックすると、フレーム選択パネルが展開されます。「Add current frame」を使うか、 `M` を押して、現在の再生位置のフレームを選択します。 `,` および `.`で個々のフレームを移動するか、 `Shift+Left` および `Shift+Right`. サンプリングされたフレームと手動で選択されたフレームは結合され重複排除され、ダイアログには抽出対象の総フレーム数がリアルタイムで表示されます。 #### トリミング フィルムストリップ上のトリムハンドルをドラッグして開始点と終了点を設定します。トリミング範囲外のフレームは除外されます。 「Extract N frames」をクリックすると、動画がフレームに分割され、データセットにアップロードされます。 複数の動画がキューに入っている場合、同じ間隔設定をすべてに適用できます。選択フレームは動画ごとに管理されるため、選択フレームがある場合は各動画ごとに個別のダイアログが開きます。
対応動画ファイル形式 Roboflow は、ブラウザに組み込まれている動画ファイル対応機能を使用して、動画をフレーム画像に解析し、モデルの学習に利用できるようにします。つまり、使用しているブラウザによって、MOV や MP4 ファイルを含むさまざまな動画形式を使用できます。 次のことができます [ブラウザでサポートされている動画形式を確認する](https://caniuse.com/?search=video%20format). 動画がブラウザでデコードできない形式の場合、Roboflow は「Scanning files」で停止する代わりに「unsupported video」エラーを表示し、ファイルの変換を促します。HEVC/H.265 は一般的な原因です（例：DJI ドローン、GoPro、新しいスマートフォンで撮影した映像）で、Safari でのみデコードできます。動画を、より広くサポートされている MP4（H.264）に再書き出しまたは変換してから、もう一度アップロードしてください。 Roboflow への動画ファイルの読み込みで問題がある場合は、 [フォーラム](https://discuss.roboflow.com/) に投稿するか、アカウント担当者に連絡してください。
## CLI Roboflow Python コマンドラインインターフェースを使用して、より大きなデータセットをアップロードできます。 コマンドラインインターフェースでアップロードできるのは画像のみです。動画がある場合は、 [ファイルとして保存されたフレームに分割する](https://superuser.com/questions/1044444/how-do-i-use-ffmpeg-to-split-a-video-into-images-and-then-reassemble-exactly-the)必要があります。これらのファイルはその後 Roboflow にアップロードできます。 はじめに、まず `roboflow-python`: ``` pip install roboflow ``` 次に、 [Workspace ID を取得します](https://docs.roboflow.com/reference/authentication/authentication/workspace-and-project-ids). 最後に、次の形式でコマンドを準備します： ``` roboflow import -w testupload -p project-1-8zgld /path/to/dataset/folder ``` 指定する必要がある引数は次のとおりです： * `-w testupload`：Workspace 名です。 * `-p `：Project ID です。 コマンドを実行すると、アップロード処理が開始されたことを示すメッセージが表示されます。その後、画像のアップロードに伴うログが表示されます：

コマンドラインを使ったデータセットのアップロード

コマンドラインからデータをアップロードする方法を示す動画チュートリアルがあります： {% embed url="" %} ### Zip ファイルをアップロードする 大きなデータセットの場合、個別のファイルではなく、1 つの `.zip` 画像とアノテーションのアーカイブをアップロードできます。アーカイブは 1 回アップロードされ、Roboflow のサーバー上で非同期に処理されるため、ファイルごとにアップロードするよりも高速で信頼性が高くなります。 次をアップロード： `.zip` 直接： ```bash roboflow image upload dataset.zip --workspace -p ``` または、アップロード前に CLI にフォルダを zip 化させることもできます： ```bash roboflow image upload ./dataset/folder --zip-upload --workspace -p ``` 既定では、コマンドは処理が完了するまで待機し、要約を出力します。 `--no-wait` を指定するとすぐに戻り、CLI はアップロード状況の確認に使えるタスク ID を出力します。 ## Python SDK を使用 `Workspace.upload_dataset()` して、 `.zip` アーカイブをアップロードするか、アップロード前にフォルダを zip 化します： ```python import roboflow rf = roboflow.Roboflow(api_key="YOUR_API_KEY") workspace = rf.workspace() # .zip のパスは自動的に検出され、アーカイブとしてアップロードされます workspace.upload_dataset("dataset.zip", project_name="your-project") # フォルダの場合は、use_zip_upload を有効にして zip 化して 1 つのアーカイブとしてアップロードします workspace.upload_dataset("./dataset/folder", project_name="your-project", use_zip_upload=True) ``` {% hint style="info" %} Zip アップロードは最大 8 GB、100,000 ファイルまでのアーカイブに対応しています。予測（`is_prediction=True`）は zip の経路ではサポートされていません。代わりに画像ごとのアップロードを使用してください。 {% endhint %} ## MCP サーバー AI エージェントを [MCP サーバー](https://docs.roboflow.com/agents/mcp-server) に接続すると、次のツールでプロジェクトに画像を追加できます：
ツール説明
image_uploadzip を介してローカル画像ファイルをプロジェクトにアップロードします。
image_upload_status画像 zip アップロードタスクの状態を確認します。
images_update_metadataアップロード済み画像のメタデータとタグを更新します。
## アップロードしたデータを表示する Roboflow にアップロードされたデータはすべて「バッチ」としてアップロードされます。これらのバッチは Project の Annotate ページで確認できます：
## 画像サイズの制限 画像の最大サイズは 20 MB です 最大ピクセル寸法は 16,400 × 10,900 ピクセルです。 ## 重複画像 すでに Project にある画像をアップロードしようとすると、その画像のアップロードはスキップされます。 {% hint style="info" %} 2 つのデータセットを [統合すると](/datasets/ja/guan-li/merge-datasets.md)、統合後のデータセットと元の 2 つのデータセットの両方がアカウント内に存在します。したがって、画像が重複しているため、統合には課金されません。 {% endhint %} ## データの所有権 Roboflow にアップロードしたすべての画像と動画の所有権は引き続きあなたにあります。これは [当社利用規約の第 23B 条](https://roboflow.com/terms): > に定義されています。 ## データのプライバシー **Public プラン：** Public プランをご利用の場合、Roboflow によって明示的に指定・設定されていない限り、データセットは Roboflow Universe で公開されます。 **有料プラン（Enterprise を含む）：** 特に指定がない限り、データはアカウント内で非公開です。