Skip to main content
このチュートリアルでは、テキスト生成または構造化された判断のPhaseoリクエストを成功させ、応答の表示場所を確認します。
コーディングエージェントを使っていますか? 始める前にこのプロンプトをコピーして貼り付けてください。
この手順で行うこと:
  • API キーを作成する
  • テキストまたは構造化された判断のリクエストを送る
  • 生成されたテキストや型付き回答を読む
  • リクエストが失敗したときに最初に確認する項目を知る

1. API キーを作成する

  1. Phaseo ダッシュボードを開きます。
  2. Gateway → キーでキーを作成します。
  3. キーを一度だけコピーし、安全な場所に保管します。
次の形式を使用します:
API キーはパスワードと同じように扱ってください。クライアント側のコードに含めないでください。

2. テキストリクエストを送信する

最初のリクエストには POST /v1/responses を使用します。新しいテキスト生成の実装に推奨されるエンドポイントです。

リクエスト

レスポンス

Responses API を直接呼び出す場合は、output[].content[] の type が output_text である項目からアシスタントの返答を読み取ります。 Vercel AI SDK を使用する場合は、result.text から返答を読み取ります。

3. 構造化された判断を行う

テキスト生成ではなく型付き回答が必要な場合はPOST /v1/decisionsを使います。PhaseoはTypeSafeのJev 1.13をモデルID typesafe/jev-1.13.0で提供します。state値と1つ以上の名前付き質問を送り、各回答は同じ名前で返されます。
Decisionsはベータ機能で、ワークスペースでの有効化が必要な場合があります。Jev 1.13の料金は入力100万トークンあたり$0.042で、出力トークンは無料です。
PHASEO_API_KEYを設定したサーバーで例を実行してください。ブラウザーのコードにGateway APIキーを公開しないでください。 質問の型は次の3つです。
  • choiceは基準のマップから1つの選択肢を選び、確率と信頼度を返します。
  • noulは0から1のはい/いいえの確率を返します。
  • scoreは順序付きの基準配列を評価し、確率で重み付けしたスコアを返します。
同じリクエストで複数の質問型を混在させられます。

リクエスト

応答

質問IDに対応する回答から型付きの値を読みます。例はanswers.department.choice、answers.is_urgent.noul、answers.customer_impact.scoreです。値だけで分岐せずにアプリケーションのしきい値を設定する場合は、confidenceとprobabilitiesを使ってください。 リクエストと応答の詳細はDecisions APIリファレンス、モデルの動作と上流の制限はTypeSafeのJevモデルリファレンスを参照してください。

4. 最初のリクエストをトラブルシューティングする

  • 401:API キーと Authorization ヘッダーを確認します。
  • 400:リクエスト本文とモデル ID を確認します。
  • 402::free モデルに切り替えるか、有料モデルを使う前にクレジットを追加します。
  • 429 または 5xx:指数バックオフで再試行します。
問題をすばやく調査するには、エラー処理のリファレンスを参照してください。

5. 動画機能を開発する場合

動画生成は非同期です。まずジョブを作成し、その後ステータスを確認するか、結果を購読します。
  1. POST /v1/videos でジョブを作成します。
  2. 完了するまで GET /v1/videos/{video_id} でステータスを確認します。
  3. GET /v1/videos/{video_id}/content からコンテンツをダウンロードします。

6. 続けて開発する

Gateway を統合する

本番環境での統合パターンとエンドポイントの選び方。

API リファレンス

すべてのエンドポイントのリクエストとレスポンスを網羅したドキュメント。

サンプル

一般的なワークフロー向けの、より詳しいリクエスト例。

サポート

デバッグ、ルーティング、モデルの動作についてサポートを受けます。
最終更新日 2026年10月2日