TermEdit

更新时间:
复制 MD 格式

Editing the Tongyi Multimodal Translation termbase

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

anytrans:TermEdit

none

*All Resource

*

None None

Request syntax

POST /anytrans/translate/intervene/edit HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

workspaceId

string

Yes

The ID of the Model Studio workspace.

llm-kqtrcpdee4xm29xx

action

string

Yes

The action type.

Valid values:

  • ADD :

    Adds an intervention term.

  • DELETE :

    Deletes an intervention term.

  • MODIFY :

    Modifies an intervention term.

ADD

sourceLanguage

string

Yes

The source language. The value must be a valid BCP-47 language code.

en

targetLanguage

string

Yes

The target language. The value must be a valid BCP-47 language code.

zh

scene

string

Yes

The model type.

Valid values:

  • mt-plus :

    Professional Edition

  • mt-turbo :

    Lite Edition

mt-turbo

ext

object

Yes

The extended parameters.

terms

array<object>

Yes

The intervention term list.

object

Yes

An intervention term.

termId

string

No

The intervention term ID.

92669964

src

string

Yes

The source text.

大模型

tgt

string

Yes

The post-intervention translation.

LLM

paramMap

any

No

The extended parameter configuration.

Valid values:

  • bizType :

    The business scenario type. Use this identifier to create scenario-specific interventions without affecting other scenarios.

  • bizUserId :

    The business user ID. Use this identifier to create user-specific interventions without affecting other users.

{"bizUserld":"123456","bizType":session"}

Response elements

Element

Type

Description

Example

object

The response schema.

code

string

The status code.

success

message

string

The message.

success

requestId

string

The request ID.

1DCD50EC-D218-1844-9CD8-E97CAB9D31BE

success

boolean

Indicates whether the API call is successful.

Valid values:

  • ture :

    The request succeeded.

  • false :

    The request failed.

true

httpStatusCode

string

The HTTP status code.

200

data

object

The response data.

terms

array<object>

An array of intervention term objects.

object

An intervention term.

termId

string

The term ID.

92669964

src

string

The source text.

大模型

tgt

string

The target text.

LLM

failCount

integer

The number of items that failed to be processed.

0

Examples

Success response

JSON format

{
  "code": "success",
  "message": "success",
  "requestId": "1DCD50EC-D218-1844-9CD8-E97CAB9D31BE",
  "success": true,
  "httpStatusCode": "200",
  "data": {
    "terms": [
      {
        "termId": "92669964",
        "src": "大模型",
        "tgt": "LLM"
      }
    ],
    "failCount": 0
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.