プライバシー設定

プライバシーおよびGDPRに関する通知

Nfero は、言語設定とデモアクセス制御のために必須ストレージを使用します。同意した場合、Google Analytics と軽量な利用イベントをモデルデモと外部サブスクリプション導線の改善に使用します。ライブデモのプロンプトは、設定済みの Alibaba ホスト型モデルエンドポイントに送信される場合があります。

ツールとモデルのペアリング

Postman / cURL with Alibaba Model Studio API

モデルスタジオのリクエスト、ヘッダー、ペイロード、エンドポイント動作の検証用APIテストルートです。

Postman および cURL は、リクエストの構造、ヘッダー、モデル動作の検証に有効ですが、これらは対話型コーディングエージェントではなく、直接的な API 呼び出しインタフェースです。

適切なアクセシルートを選択

適切なアクセシルートを選択

一般的な pay-as-you-go Model Studio API キーと、対応するリージョンエンドポイントをご使用ください。Alibaba では、Postman から Coding Plan を直接呼び出すことを明示的に推奨していません。

おすすめPay-as-you-go Model Studio API

Token Plan(チーム版)

直接呼び出しの包括的な権限として使用しないでください。テストおよびアプリケーション連携には、汎用の API エンドポイントをご利用ください。

Coding Plan

Alibaba は明確に、Postman を利用した呼び出しを推奨しておらず、非対話型の API シナリオを禁止しています。

Pay-as-you-go Model Studio API

手動による API 検証、スクリプト実行、統合テスト、バックエンド開発に適した正しいプランです。

安全な設定パターン

汎用 OpenAI 互換 Model Studio エンドポイントのテスト

この例は意図的に内容を伏せています。プレースホルダーの置き換えはお使いのデバイス上でのみ行い、実際の API キーを Nfero に貼り付けないでください。

始める前に

  1. デプロイメントリージョンで、一般的な Model Studio API キーを作成します。
  2. 同じリージョンおよび API プロトコルに対応するモデルを選択します。
  3. キーを Postman のシークレット/現在値、または環境変数に保存します。
  4. リクエストの繰り返しや自動化を行う前に、課金アラートを設定してください。

安全な設定パターン

プロトコル
OpenAI-compatible Model Studio API
  1. Alibaba のベース URL ドキュメントに記載されているリージョン固有の汎用エンドポイントを使用してください。
  2. APIキーを Authorization ヘッダーで送信し、画面表示やソースコードへのコミットは絶対に行わないでください。
  3. 短いプロンプトと低い出力制限から始めます。
  4. リクエストの検証後、本番用コードはサーバーサイドのシークレットストレージへ移行してください。

接続を確認

  • キーのリージョンがエンドポイントと一致しているか確認してください。
  • レスポンスのステータス、リクエストID、モデルID、使用量フィールドを確認してください。
  • エクスポートされた Postman コレクションに、現在のシークレット値が含まれていないことを確認してください。
  • エンドポイントがプラン固有のURLではなく、汎用の Model Studio エンドポイントであることを確認してください。

モデルのペアリング

推奨スターティングモデル

このツール を使用して、各モデル で対話型のコード作成、推論、レビュー、ドキュメンテーションなどのタスクを実行してください。本番環境での使用前に、Alibaba Cloud で最終的なモデルの利用可能性と正確なプランのサポートを確認してください。

テキスト生成推論視覚的理解
最適なペアリング角度

現在の汎用モデルルートです。キーのリージョンで利用可能であることを確認してください。

テキスト生成推論視覚的理解
最適なペアリング角度

リクエスト形式のテストおよび基本的な統合チェックに効率的なオプションです。

よくある問題

よくある問題

現象

401 エラー:不正な API キー

考えられる原因

APIキーが不足している、途中で切れている、または他のプラン/リージョンのものである可能性があります。

対処方法

エンドポイントと同じ Model Studio リージョンおよびワークスペースから取得した汎用キーを使用してください。

現象

予期しないプランの一時停止またはキーのブロック

考えられる原因

Coding Plan キーまたは Token Plan キーが、直接的または自動化された API 呼び出しに使用されています。

対処方法

これを、汎用の pay-as-you-go Model Studio API キーに置き換えてください。

重要な制限事項

  • 実際のキーを Nfero、公開コレクション、共有を目的としたコマンド履歴、またはソース管理システムに貼り付けないでください。
  • 直接スクリプト、バッチテスト、バックエンド呼び出しには、Coding Plan または Token Plan の認証情報は使用しないでください。
  • リクエスト動作の検証中は、低めの制限と課金アラートを活用してください。