専用エンドポイント
Ultralytics Platformは、YOLOモデルを43のグローバルリージョンにある専用エンドポイントにデプロイすることを可能にします。各エンドポイントは、オートスケーリング、カスタムURL、および独立したモニタリングを備えたシングルテナントサービスです。
エンドポイントを作成
モデルを専用エンドポイントにデプロイする:
- モデルに移動
- デプロイタブをクリック
- マップからリージョンを選択
- デプロイをクリック
領域選択
世界43のリージョンから選択:
インタラクティブマップは以下を示します:
- リージョンピン:クリックして選択
- レイテンシインジケーター:距離に応じて色分け
- Green: <100ms
- 黄:100-200ms
- 赤:>200ms
リージョン表
詳細付きで全リージョンを表示:
| 列 | 説明 |
|---|---|
| リージョン | リージョン識別子 |
| ロケーション | 都市/国 |
| レイテンシー | Ping測定時間 |
| ステータス | 利用可能/デプロイ済み |
慎重に選択してください
低レイテンシを実現するため、ユーザーに最も近いリージョンを選択してください。グローバルなカバレッジを確保するために、複数のリージョンへのデプロイも検討してください。
利用可能なリージョン
アメリカ大陸(14地域)
| ゾーン | ロケーション |
|---|---|
| us-central1 | アイオワ州、米国 |
| us-east1 | サウスカロライナ州、米国 |
| us-east4 | バージニア州、米国 |
| us-east5 | アメリカ合衆国オハイオ州 |
| us-west1 | オレゴン州、米国 |
| us-west2 | ロサンゼルス、米国 |
| us-west3 | ソルトレイクシティ、米国 |
| us-west4 | ラスベガス、米国 |
| us-south1 | ダラス、米国 |
| northamerica-northeast1 | モントリオール、カナダ |
| northamerica-northeast2 | トロント、カナダ |
| southamerica-east1 | サンパウロ、ブラジル |
| southamerica-west1 | サンティアゴ、チリ |
ヨーロッパ (12リージョン)
| ゾーン | ロケーション |
|---|---|
| europe-west1 | ベルギー |
| europe-west2 | ロンドン、英国 |
| europe-west3 | フランクフルト、ドイツ |
| europe-west4 | オランダ |
| europe-west6 | チューリッヒ、スイス |
| europe-west8 | ミラノ、イタリア |
| europe-west9 | パリ、フランス |
| europe-west10 | ベルリン、ドイツ |
| europe-west12 | トリノ、イタリア |
| europe-north1 | フィンランド |
| europe-central2 | ワルシャワ、ポーランド |
| europe-southwest1 | マドリード、スペイン |
アジア太平洋地域(14地域)
| ゾーン | ロケーション |
|---|---|
| asia-east1 | 台湾 |
| asia-east2 | 香港 |
| asia-northeast1 | 東京、日本 |
| asia-northeast2 | 大阪、日本 |
| asia-northeast3 | 韓国、ソウル |
| asia-south1 | ムンバイ、インド |
| asia-south2 | デリー、インド |
| asia-southeast1 | シンガポール |
| asia-southeast2 | ジャカルタ、インドネシア |
| australia-southeast1 | シドニー、オーストラリア |
| australia-southeast2 | メルボルン、オーストラリア |
中東・アフリカ(3地域)
| ゾーン | ロケーション |
|---|---|
| me-central1 | ドーハ、カタール |
| me-central2 | ダンマーム、サウジアラビア |
| me-west1 | テルアビブ、イスラエル |
エンドポイント設定
エンドポイント作成時:
| 設定 | 説明 | デフォルト |
|---|---|---|
| リージョン | デプロイリージョン | - |
| 最小インスタンス数 | 最小実行インスタンス数 | 0 |
| 最大インスタンス数 | 最大スケーリング制限 | 10 |
スケーリングオプション
| 設定 | 動作 |
|---|---|
| 最小 = 0 | アイドル時にゼロにスケール (費用対効果が高い) |
| 最小 > 0 | コールドスタートなしで常時稼働 |
| 最大 | トラフィックスパイクの上限 |
コールドスタート
最小インスタンス数 = 0 の場合、アイドル後の最初のリクエストでコールドスタート (2~5秒) が発生します。レイテンシに敏感なアプリケーションでは、最小インスタンス数 > 0 に設定してください。
エンドポイントを管理
エンドポイントの表示と管理:
エンドポイント詳細
| フィールド | 説明 |
|---|---|
| URL | リクエスト用HTTPSエンドポイント |
| リージョン | デプロイ済みリージョン |
| ステータス | 実行中、停止済み、デプロイ中 |
| インスタンス | 現在の/最大インスタンス数 |
エンドポイントURL
各エンドポイントには一意のURLがあります:
https://model-abc123-us-central1.a.run.app
コピーボタンをクリックしてURLをコピーします。
ライフサイクル管理
エンドポイントの状態を制御します:
| アクション | 説明 |
|---|---|
| 開始 | 停止中のエンドポイントを再開します |
| 停止 | エンドポイントを一時停止します(課金なし) |
| 削除 | エンドポイントを完全に削除します |
エンドポイントを停止
エンドポイントを停止して課金を一時停止します:
- エンドポイントアクションメニューを開きます
- 停止をクリックします
- アクションを確認します
停止済みエンドポイント:
- リクエストを受け付けません
- 料金は発生しません
- いつでも再起動できます
エンドポイントを削除
エンドポイントを完全に削除します:
- エンドポイントアクションメニューを開きます
- 削除をクリックします
- 削除を確認
恒久的な操作
削除は即座に、かつ永続的に行われます。新しいエンドポイントはいつでも作成できます。
エンドポイントの使用
認証
リクエストにAPIキーを含めます:
Authorization: Bearer YOUR_API_KEY
リクエスト例
curl -X POST \
"https://model-abc123-us-central1.a.run.app/predict" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@image.jpg"
import requests
url = "https://model-abc123-us-central1.a.run.app/predict"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
files = {"file": open("image.jpg", "rb")}
response = requests.post(url, headers=headers, files=files)
print(response.json())
応答形式
タスク固有のフィールドを持つ共有推論と同じです。
料金
専用エンドポイントの課金基準:
| コンポーネント | レート |
|---|---|
| CPU | vCPU秒あたり |
| メモリ | GB秒あたり |
| リクエスト | 100万リクエストあたり |
コスト最適化
- 開発用エンドポイントにはスケール・トゥ・ゼロを使用します。
- 適切な最大インスタンス数を設定します。
- 監視ダッシュボードで利用状況を監視します。
よくある質問
いくつのエンドポイントを作成できますか?
厳密な制限はありません。各モデルは複数のリージョンにエンドポイントを持つことができます。総エンドポイント数はプランによって異なります。
デプロイ後にリージョンを変更できますか?
いいえ、リージョンは固定されています。リージョンを変更するには:
- 既存のエンドポイントを削除します。
- 希望するリージョンに新しいエンドポイントを作成します。
マルチリージョンデプロイメントはどのように扱いますか?
グローバルカバレッジの場合:
- 複数のリージョンにデプロイします。
- ロードバランサーまたはDNSルーティングを使用します。
- ユーザーを最寄りのエンドポイントにルーティングします。
コールドスタート時間はどのくらいですか?
コールドスタートはモデルサイズによって異なります:
| モデル | コールドスタート |
|---|---|
| YOLO26n | 約2秒 |
| YOLO26m | 約3秒 |
| YOLO26x | 約5秒 |
コールドスタートをなくすには、最小インスタンス数を0より大きく設定します。
カスタムドメインを使用できますか?
カスタムドメインは近日公開予定です。現在、エンドポイントはプラットフォームが生成したURLを使用しています。