alicloud-ai-translation-anytrans

カテゴリ：サービス

TongyiTranslate

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

ワークフロー

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

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

1. 環境変数：ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID リージョンのポリシー：ALICLOUD_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 を呼び出す前に、メタデータを確認します。

python scripts/list_openapi_meta_apis.py

オプションのオーバーライド：

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

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

出力ポリシー

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

検証

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

合格基準：コマンドが 0 で終了し、output/alicloud-ai-translation-anytrans/validate.txt が生成されること。

出力と証拠

• アーティファクト、コマンド出力、API レスポンスの要約を output/alicloud-ai-translation-anytrans/ に保存します。
• 再現できるよう、証拠ファイルに主要なパラメーター（リージョン／リソース ID／期間）を含めます。

前提条件

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

参考資料

• ソース：references/sources.md