EastX を OpenAI Python SDK で使う方法｜初回リクエストとエラー対処

EastX を OpenAI Python SDK で使うには？

EastX でテキストの Chat Completions を呼び出すには、Python SDK の base_url に https://api.eastx.ai/v1 を指定し、EastX の API キーと利用可能なモデルの正確な ID を設定します。既存の SDK を使いながら、クライアントやプロジェクトごとにキーと予算を分け、利用量を EastX のコンソールで確認できます。

1. キーとモデルを用意する

コンソールでテスト用のキーを作成します。キーに設定された利用上限、モデルの許可、送信元 IP の制限を確認してください。キーは環境変数 EASTX_API_KEY に設定します。公開リポジトリやブラウザーで動くコードに書き込まないでください。

モデル名は表示名ではなく、モデルと料金 または API のモデル一覧から取得した ID を使います。テキストの Chat Completions に対応するモデルを選び、環境変数 EASTX_MODEL に設定します。

2. 短いリクエストを送る

python -m pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["EASTX_API_KEY"],
    base_url="https://api.eastx.ai/v1",
    timeout=60.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["EASTX_MODEL"],
    messages=[{"role": "user", "content": "一文で自己紹介してください。"}],
)
print(response.choices[0].message.content)
print(response.usage)

出力が返ったら、コンソールで同じ時刻とモデルの利用記録を確認します。入力と出力の量は別々に記録し、キャッシュや段階料金がある場合は適用された条件も確認します。実際のリクエストには利用料金が発生する場合があります。

3. HTTP ステータスから原因を切り分ける

• 401 / 403：キーの入力、モデルの許可、送信元 IP の設定を確認します。
• 402：残高とキーごとの利用上限を両方確認します。
• 404：モデル ID と URL を確認します。SDK に指定するのは /v1 までで、/chat/completions は SDK が付けます。
• 429：並列リクエストを減らし、Retry-After がある場合はその指示に従います。
• 5xx / タイムアウト：時刻とリクエスト識別子を保存し、処理と課金の状態を確認してから再試行します。

4. 実際の作業でモデルを比較する

最初に同じ入力を短いリクエストで比較し、次に本番で使うストリーミングやツール呼び出しを確認します。モデルによって使えるパラメーターやエンドポイントが異なります。クライアントごとにキーを分けると、予算と利用記録を対応づけて確認できます。

• EastX API ドキュメント
• SDK クイックスタート（中国語・英語）