Getting essay grading results
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.
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
Actionelement 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
Resourceelement of the policy. - For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the
Resourceelement of the policy.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the
- 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 |
|---|---|---|---|---|
quanmiaolightapp:GetEssayCorrectionTask | get | *All Resource
| None | None |
Request syntax
Path Parameters
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| workspaceId | string | No | llm-xxx |
Request parameters
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| taskId | string | No | The unique identifier for the task. | a3d1c2ac-f086-4a21-9069-f5631542f5a2 |
Response elements
Element | Type | Description | Example |
|---|---|---|---|
object | The response schema. | ||
| requestId | string | The request ID. | 117F5ABE-CF02-5502-9A3F-E56BC9081A64 |
| code | string | The error code. | successful |
| httpStatusCode | integer | The HTTP status code. | 200 |
| message | string | The response message. | successful |
| success | boolean | Indicates whether the request was successful. Valid values: | false |
| data | object | The result object. | |
| status | string | The task status. Valid values: | PENDING |
| errorMessage | string | The error message. | Task error message |
| results | array<object> | A list of results. | |
array<object> | The result object. | ||
| customId | string | The custom ID that you specified for the task. | 1 |
| errorMessage | string | The error message. This field is returned only if an error occurs for the specific task. | Model rate limit triggered |
| errorCode | string | The error code. This field is returned only if an error occurs for the specific task. | RateLimit |
| result | string | The review result. | Review result |
| score | integer | The essay review score. | 58 |
| dimensionResults | array<object> | The scoring results for each dimension. This parameter is returned in the custom dimension mode. | |
object | The scoring result for a dimension. | ||
| name | string | The dimension name. | Content completeness |
| analysis | string | An analysis of strengths and weaknesses for the dimension. | The essay content is relatively complete and covers the core requirements of the topic, but some arguments are somewhat brief. |
| score | number | The score for the dimension. | 25.5 |
| maxScore | number | The maximum score for the dimension. | 30 |
| overallComment | string | The overall comment. | Overall performance is good. We recommend further strengthening the depth of the arguments. |
| usage | ModelUsage | The token usage for the task. | |
| totalUsage | ModelUsage | The total token usage for all tasks. |
Examples
Success response
JSON format
Error codes
HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 403 | NoPermission | You are not authorized to perform this action , Please check the assignment of the workspaceId. |