本文へスキップ
AI-Papers

HuggingFace Jobsで vLLM 推論サーバーをコマンド1つで起動、プロビジョニング不要のLLMエンドポイント

(更新: 2026年9月12日)
HuggingFace Jobsで vLLM 推論サーバーをコマンド1つで起動、プロビジョニング不要のLLMエンドポイント
  • HuggingFace Jobsで vLLM の OpenAI 互換エンドポイントをコマンド1つで起動可能になった。サーバー構築や Kubernetes の知識は不要
  • A10G から H200×8 までの GPU フレーバーを選択でき、秒単位の従量課金で実験・評価向けに柔軟に使える
  • 全リクエストに HuggingFace トークンが必須で、エンドポイントへのアクセスはユーザー・組織単位でゲートされる

2026年6月の発表概要

2026年6月26日、HuggingFace は公式ブログで「HuggingFace Jobs 上で vLLM 推論サーバーをコマンド1つで起動する方法」を発表した。サーバーのプロビジョニングも Kubernetes の設定も不要で、huggingface_hub のバージョン 1.20.0 以上をインストールして HuggingFace アカウントにログインするだけで、本番レベルの OpenAI 互換エンドポイントをすぐに利用できる。

HuggingFace Jobs は、GPU リソースの確保から環境構築までの手間を抽象化したジョブ実行サービスだ。今回はその上で、LLM 推論に広く使われるフレームワーク vLLM(Large Language Model 推論・サービングエンジン)の公式 Docker イメージを直接実行できるようになった。

コマンド例と基本的な使い方

たとえば Qwen/Qwen3-4B を A10G GPU で起動する場合、以下のコマンドを実行するだけでエンドポイントが立ち上がる。

hf jobs run --flavor a10g-large --expose 8000 --timeout 2h vllm/vllm-openai:latest vllm serve Qwen/Qwen3-4B --host 0.0.0.0 --port 8000

主なオプションの役割は次のとおりだ。

  • --flavor: GPU の種類を指定する
  • --expose: コンテナのポートを指定する
  • --timeout: 自動停止までの時間を指定する

起動後はジョブ ID が払い出され、https://<job_id>--8000.hf.jobs/v1/chat/completions という URL でアクセスできる。認証には HuggingFace トークンをそのまま Bearer トークンとして使用するため、既存の HuggingFace アカウントで完結する。

大規模モデルを複数 GPU で動かす場合も同様のコマンド体系で対応できる。122B パラメータの Qwen/Qwen3.5-122B-A10B を 2 枚の H200 で起動する際は --tensor-parallel-size 2 を追加し、--max-model-len 32768 でコンテキスト長を、--max-num-seqs 256 で並行処理数を制御する。利用可能なハードウェア構成は hf jobs hardware コマンドで一覧表示できる。

対応 GPU と料金体系

発表時点で利用可能な主なフレーバーとして、記事では以下の構成が例示されている。

フレーバー

GPU 構成

料金

a10g-large

A10G GPU 搭載

時間あたり 1.50 ドル

h200x2

H200 GPU 2 枚

記載なし

h200x8

H200 GPU 8 枚

記載なし

いずれも秒単位の従量課金で、使い終わったら hf jobs cancel <job_id> で明示的にキャンセルすることで無駄なコストを抑えられると説明されている。前提条件は支払い方法またはプリペイドクレジットの登録に加え、huggingface_hub >= 1.20.0 のインストールと hf auth login によるローカル認証のみだ。

対応モデルと拡張オプション

HuggingFace がホストするモデルであれば基本的にそのまま指定できる。発表記事では Qwen シリーズが具体例として取り上げられているが、モデル ID を変更するだけで他の公開モデルにも対応できる仕組みになっている。

また、思考ステップを別途パースしたい場合は --reasoning-parser deepseek_r1 オプションを追加でき、コーディングエージェントのバックエンドとして使う場合は --enable-auto-tool-choice でツール呼び出しを有効化できる。Gradio を使ったチャット UI の構築例や、hf jobs ssh <job_id> による SSH デバッグも記事内で紹介されており、実験・評価・バッチ生成といった用途を一通りカバーする。

OpenAI の Python クライアントからは base_url にエンドポイント URL を、api_key に HuggingFace トークンを渡すだけで既存のコードをほぼそのまま流用できる。vLLM は OpenAI 互換 API を話せると HuggingFace は説明しており、移行コストを最小化するうえでの利点として位置づけている。

HuggingFace Jobs と Inference Endpoints の違い

HuggingFace は今回の機能について、同社が提供するもう一つのサービス「Inference Endpoints」との使い分けも明示している。HuggingFace Jobs は柔軟性と制御性を最大化したい実験・評価・バッチ生成向けのサービスで、秒単位課金でコストを抑えながら素早くプロトタイプを構築したい開発者に向く。

一方 Inference Endpoints は本番環境向けに最適化されており、公開・保護・プライベートの三段階のアクセス制御とスケールゼロ機能(トラフィックがゼロになると自動でスケールダウン)を備えていると説明されている。

今回の発表は、推論インフラの知識を持たない開発者がエンドポイントを素早く立ち上げて実験や評価を始められる、という入り口を新たに整えたものといえる。セキュリティ面では、エンドポイントへのアクセスはユーザーおよび組織の単位でゲートされ、すべてのリクエストに HuggingFace トークンが必要な設計になっている。

シェア:

投稿には GitHub アカウントが必要です。投稿内容は公開され、利用規約に反するものは予告なく削除します。