How does it determine which TongyiTranslate API to call?

It uses OpenAPI metadata to list AnyTrans APIs and inspect required schemas before calling business APIs. The default API version is 2025-07-07.

Which Alibaba Cloud credentials and region settings does it use?

It prioritizes ALICLOUD_ACCESS_KEY_ID and ALICLOUD_ACCESS_KEY_SECRET environment variables, with optional ALICLOUD_REGION_ID, then falls back to ~/.alibabacloud/credentials. If the region is unclear, it asks before mutating resources.

How are operations verified and recorded?

Changes are checked with Describe* or List* APIs. Artifacts, command outputs, API response summaries, and reproducibility parameters are stored under output/alicloud-ai-translation-anytrans/ when saved.

Coding

Alibaba Cloud AI Translation Anytrans

Manage and verify TongyiTranslate resources through Alibaba Cloud OpenAPI or official SDKs.

What it does

Manage Alibaba Cloud TongyiTranslate resources through RPC APIs using official SDKs or OpenAPI Explorer. The workflow confirms region and resource IDs, discovers AnyTrans API schemas for version 2025-07-07, performs list, configuration, or status operations, and verifies changes with describe/list calls. Evidence and response summaries can be saved under the designated output directory.

When to use it

Inventorying TongyiTranslate resources
Creating or updating resource configuration
Checking resource status and troubleshooting
Recording reproducible API evidence

The skill document

Category: service

TongyiTranslate

Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage resources for TongyiTranslate.

Workflow

Confirm region, resource identifiers, and desired action.
Discover API list and required parameters (see references).
Call API with SDK or OpenAPI Explorer.
Verify results with describe/list APIs.

AccessKey priority (must follow)

Environment variables: ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID Region policy: ALICLOUD_REGION_ID is an optional default. If unset, decide the most reasonable region for the task; if unclear, ask the user.
Shared config file: ~/.alibabacloud/credentials

API discovery

Product code: AnyTrans
Default API version: 2025-07-07
Use OpenAPI metadata endpoints to list APIs and get schemas (see references).

High-frequency operation patterns

Inventory/list: prefer List* / Describe* APIs to get current resources.
Change/configure: prefer Create* / Update* / Modify* / Set* APIs for mutations.
Status/troubleshoot: prefer Get* / Query* / Describe*Status APIs for diagnosis.

Minimal executable quickstart

Use metadata-first discovery before calling business APIs:

python scripts/list_openapi_meta_apis.py

Optional overrides:

python scripts/list_openapi_meta_apis.py --product-code  --version

The script writes API inventory artifacts under the skill output directory.

Output policy

If you need to save responses or generated artifacts, write them under: output/alicloud-ai-translation-anytrans/

Validation

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

Pass criteria: command exits 0 and output/alicloud-ai-translation-anytrans/validate.txt is generated.

Output And Evidence

Save artifacts, command outputs, and API response summaries under output/alicloud-ai-translation-anytrans/.
Include key parameters (region/resource id/time range) in evidence files for reproducibility.

Prerequisites

Configure least-privilege Alibaba Cloud credentials before execution.
Prefer environment variables: ALICLOUD_ACCESS_KEY_ID, ALICLOUD_ACCESS_KEY_SECRET, optional ALICLOUD_REGION_ID.
If region is unclear, ask the user before running mutating operations.

References

Sources: references/sources.md

Questions people ask

How does it determine which TongyiTranslate API to call?: It uses OpenAPI metadata to list AnyTrans APIs and inspect required schemas before calling business APIs. The default API version is 2025-07-07.
Which Alibaba Cloud credentials and region settings does it use?: It prioritizes ALICLOUD_ACCESS_KEY_ID and ALICLOUD_ACCESS_KEY_SECRET environment variables, with optional ALICLOUD_REGION_ID, then falls back to ~/.alibabacloud/credentials. If the region is unclear, it asks before mutating resources.
How are operations verified and recorded?: Changes are checked with Describe* or List* APIs. Artifacts, command outputs, API response summaries, and reproducibility parameters are stored under output/alicloud-ai-translation-anytrans/ when saved.