GetAPI.ONE

Python から GetAPI.ONE を呼び出す

公式 OpenAI Python SDK をインストールし、ONE ベース URL を指定し、管理された Responses リクエストを実行します。認証情報をソースコードに記載せず結果を確認します。

プロジェクトと認証情報を準備

Python 3.10 以降と仮想環境。
意図的に有効期限と上限を設定した、有効な GetAPI.ONE API キー。
Responses エンドポイントを明示した現在のカタログからコピーしたモデル ID。

powershell

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

設定してリクエストを送信

プロセス環境に GETAPI_ONE_API_KEY を設定し、ファイルにキーを貼り付けないでください。
base_url を https://www.getapi.one/v1 としてクライアントを作成します。
目立つモデルのプレースホルダーを、Responses を明示した現在のカタログの正確な ID に置き換えます。
リクエストに課金される可能性を受け入れられる場合のみスクリプトを実行します。
最初の確認では SDK の再試行を無効にします。安全に繰り返せる操作を判断してから、回数を制限し観測可能な再試行だけを追加します。

python main.py

import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

仕様を理解

項目	必要な値
base_url	https://www.getapi.one/v1
api_key	サーバー環境の GETAPI_ONE_API_KEY
model	現在のカタログの正確な ID
メソッド	client.responses.create

期待した結果を確認

認証やエンドポイントのエラーなくプロセスが終了すること。
response.output_text に要求した短い回答が含まれること。
GetAPI.ONE コンソールに、そのキーに対応するリクエスト記録または使用記録が表示されること。

一般的なエラーを解決

症状	確認
401 または認証エラー	ONE キーをコピーし直し、有効であることと、環境変数がこのプロセスに属することを確認します。
404	base_url に /v1 を正確に 1 つ残し、Responses メソッドはそのエンドポイントを明示したモデルにのみ使用します。
モデルが利用不能または非互換	現在のカタログから正確な ID を再度コピーし、別名を推測しないでください。

連携の安全を保つ

SDK は信頼できるサーバーやローカルツールのコードでのみ実行し、ブラウザーの JavaScript では実行しないでください。
.env ファイルをバージョン管理から除外し、キーが露出したら直ちに更新します。
開発と本番には別々の範囲限定キーを使用します。

次の手順

応答をストリーミングSSE のライフサイクルイベントと終了結果を処理します。
モデルを選ぶタスクをカタログのエンドポイント仕様に合わせます。