メインコンテンツへスキップ
API キーを作成し、POST /v1/responses にリクエストを 1 回送信して、output_text から返答を読みます。

コーディングエージェントで始める

このプロンプトをコーディングエージェントにコピーしてください。プロジェクトの言語を判断して SDK をインストールし、Phaseo のドキュメントを参照させ、キーをコードに含めず、最初のリクエストを送ります。プロジェクトですでに Phaseo を使っている場合は、最初からやり直さずに既存の設定を見直します。phaseo/free はクレジットなしで使えます。モデル の任意のテキストモデル ID に置き換えられます。

コーディングエージェント用のセットアッププロンプト。 コピーするか、Cursor で開いてください。

Cursorで開く
自分で設定する場合は、以下の手順に従ってください。

1. API キーを作成する

ダッシュボードの 設定 -> APIキー でキーを作成し、エクスポートします。
キーは一度だけ表示されます。すべてのリクエストで、キーをベアラートークンとして送信します。
API キーはパスワードと同じように扱ってください。サーバー側のコードに保管し、ブラウザーやモバイルアプリには絶対に含めないでください。

有料モデル用にクレジットを追加する

phaseo/free はクレジットなしで動作します。openai/gpt-6-astra などの有料モデルにはウォレット残高が必要です。
保存済みのカードがある場合は、ワークスペースのオーナーまたは管理者がメールのリンクから請求を確認します。保存済みのカードがない場合は、コマンドが支払いリンクを返し、オーナーまたは管理者がそれを開いて支払います。カードは以降のチャージ用に保存されます。

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

新しいテキスト処理には POST /v1/responses をおすすめします。例では有料モデルの openai/gpt-6-astra を使います。クレジットなしで試すには、利用可能な無料モデルを選ぶ phaseo/free に置き換えてください。無料ルーターでリリースするを参照してください。 cURL と fetch は何もインストールせずに使えます。SDK を使う場合は、先にインストールしてください。
実行環境の要件とその他の SDK については、TypeScript と Python のインストールページを参照してください。

3. 返答を読む

返答をストリーミングする

ストリーミングすると、生成されるそばから返答を表示できます。各 response.output_text.delta イベントの text には新しいテキストだけが含まれるため、このループは回答を 1 回だけ表示します。response.output_text.done などの終了イベントは、すでにストリーミングされたテキストを繰り返します。イベントの一覧はストリーミングを参照してください。

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

エラーリファレンスに、すべてのエラーコードと対処方法が掲載されています。

テキストの代わりに型付きの回答を得る

コードで文章ではなく値が必要な場合は、POST /v1/decisions(ベータ)に質問を送信します。各回答は確率付きの型付きの値として、質問と同じ順序で返されます。質問の種類は predicate(はい/いいえ)、choice(指定した選択肢のいずれか)、score(指定した尺度上のレベル)です。
レスポンス(値は例示です):
answers[0].choice や answers[1].probability を読み、confidence や probabilities を使って独自のしきい値を設定してください。Decisions リファレンスには、すべての判断モデルとその上限・料金、画像入力、そして名前付きの質問マップ(noul、criteria)を使う以前の state 形式が掲載されています。この形式は引き続き動作し、一部のモデルでは必須です。

動画を生成する

動画生成は非同期です。ジョブを作成し、ポーリングしてから、ファイルをダウンロードします。
ポーリングの代わりに Webhook を受け取るには、非同期ジョブと Webhookを参照してください。

開発を続ける

Gateway と統合する

エンドポイントを選び、本番環境向けの統合を設定します。

API リファレンス

すべてのエンドポイントの、すべてのリクエストとレスポンスのフィールド。

サンプル

一般的なワークフロー向けのスターターアプリケーション。

サポート

デバッグ、ルーティング、モデルの動作に関するサポートを受けられます。
最終更新日 2026年11月16日