メインコンテンツへスキップ
標準ライブラリだけで動く Python CLI を実行し、Phaseo のエンドポイントを 1 コマンドずつ呼び出します。完成すると、health、models、Responses、Chat Completions に対して python quickstart.py <command> が動作し、さらにワーカーやバックエンドにコピーできる embeddings、モデレーション、画像、OCR、動画、音楽のコマンドもそろいます。 この CLI は説明用です。パッケージ化されたツールではなく、リクエストの形を確認するための参考実装です。メディア系コマンドの既定のモデル ID のいくつかはすでに提供されていないため、それらには --model を渡してください(メディア系コマンドのモデルを選ぶを参照)。 同様の CLI をコーディングエージェントにゼロから作らせるには、次のプロンプトを貼り付けます。

Phaseo のルートを使う Python ゲートウェイ CLI を作成します。

Cursorで開く

CLI でできること

サンプルは examples/gateway-python-quickstart です。urllib、json、argparse だけを使う quickstart.py 1 ファイルで構成されています。 どのリクエストも、429、5xx、ネットワークエラーのときに 1 秒、2 秒と待って 2 回まで再試行し、45 秒でタイムアウトします。各コマンドは呼び出しが 2xx でない場合に 1 で終了するため、スクリプトの中で使えます。

実行する

Python 3 と Phaseo の API キーが必要です。
1

.env.local を作成する

スクリプトは、実行したフォルダーにある .env.local を読み込みます。サンプルには .env.example がないため、ファイルを作成します。
.env.local
シェルですでに設定されている変数は、ファイルの値より優先されます。PHASEO_MODEL がない場合、テキスト系コマンドは openai/gpt-5.6-sol を使います。
2

スモークチェックを実行する

smoke は短い Responses リクエストも 1 件送るため、クレジットを少し消費します。
3

リクエストを 1 件送る

動作を確認する

  • smoke はすべてのブロックで HTTP 200 を表示し、0 で終了します。
  • responses コマンドの出力に integration_ok が含まれます。
  • --help はリクエストを送らずにコマンドの一覧を表示します。
  • キーがない場合、スクリプトは Missing PHASEO_API_KEY を表示して 1 で終了します。
  • リクエストは 設定 → 使用量 → ログ に表示されます。

メディア系コマンドのモデルを選ぶ

quickstart.py の次の既定値は、提供終了しているか、有効なプロバイダーがありません。--model で現在のモデルを渡してください。モデルはモデルページまたは python quickstart.py models から選べます。 embeddings(google/gemini-embedding-2)と image(openai/gpt-image-2)の既定値は提供中です。動画と音楽のジョブは非同期です。返された ID を保存して、ステータス確認のコマンドでポーリングしてください。ジョブのライフサイクルは非同期の動画とバッチで説明しています。 ファイルはサービスに必要なコマンドだけに絞り込み、共通の gateway_request() ヘルパーは 1 つ残します。型付きのリクエストを使いたい場合は、Python SDK に切り替えてください。
最終更新日 2026年11月5日