aliyun-anytrans-translate

カテゴリ：サービス

TongyiTranslate

Alibaba Cloud OpenAPI（RPC）を公式 SDK または OpenAPI Explorer で使用して、TongyiTranslate のリソースを管理します。

ワークフロー

1. リージョン、リソース識別子、実行する操作を確認します。
2. API の一覧と必須パラメーターを確認します（参考資料を参照）。
3. SDK または OpenAPI Explorer で API を呼び出します。
4. describe/list API で結果を確認します。

AccessKey の優先順位（必ず従ってください）

1. 環境変数：ALIBABACLOUD_ACCESS_KEY_ID／ALIBABACLOUD_ACCESS_KEY_SECRET／ALIBABACLOUD_REGION_ID リージョンのポリシー：ALIBABACLOUD_REGION_ID は省略可能なデフォルト値です。未設定の場合は、タスクに最も適したリージョンを選択します。不明な場合は、ユーザーに確認してください。
2. 共有設定ファイル：~/.alibabacloud/credentials

API の確認

• プロダクトコード：AnyTrans
• デフォルトの API バージョン：2025-07-07
• OpenAPI メタデータエンドポイントを使用して API の一覧を取得し、スキーマを確認します（参考資料を参照）。

高頻度の操作パターン

1. インベントリ／一覧：現在のリソースを取得するには、List*／Describe* API を優先します。
2. 変更／設定：変更を行うには、Create*／Update*／Modify*／Set* API を優先します。
3. ステータス／トラブルシューティング：診断には、Get*／Query*／Describe*Status API を優先します。

最小限の実行可能なクイックスタート

ビジネス API を呼び出す前に、メタデータを確認して API を検出します。

python scripts/list_openapi_meta_apis.py

オプションの上書き設定：

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

このスクリプトは、API インベントリアーティファクトをスキルの出力ディレクトリに書き込みます。

出力ポリシー

レスポンスや生成されたアーティファクトを保存する必要がある場合は、次の場所に書き込んでください。 output/aliyun-anytrans-translate/

検証

mkdir -p output/aliyun-anytrans-translate
for f in skills/ai/translation/aliyun-anytrans-translate/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-anytrans-translate/validate.txt

合格基準：コマンドが 0 で終了し、output/aliyun-anytrans-translate/validate.txt が生成されます。

出力と証跡

• アーティファクト、コマンド出力、API レスポンスの概要を output/aliyun-anytrans-translate/ に保存します。
• 再現性を確保するため、証跡ファイルに主要なパラメーター（リージョン／リソース ID／時間範囲）を記載します。

前提条件

• 実行前に、最小権限の Alibaba Cloud 認証情報を設定します。
• 環境変数の使用を推奨します：ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、省略可能な ALIBABACLOUD_REGION_ID。
• リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認してください。

参考資料

• ソース：references/sources.md