Đưa tính năng chấm AI vào ứng dụng của bạn

Response: Envelope { data, meta } của AIHUB. data khớp hợp đồng chấm bài: overall_band chạy từ 0 đến 9 theo bội số 0.5, criteria luôn có đúng 4 phần tử theo thứ tự cố định (bắt đầu bằng task_achievement), kèm summary, suggestions, next_steps và annotations trích nguyên văn câu trong bài. meta cho request_id để báo hỗ trợ, service, operation và các số đo thời gian; correlation_id chỉ xuất hiện khi bạn gửi X-Correlation-Id.

{
  "data": {
    "overall_band": 6.5,
    "language": "vi",
    "criteria": [
      {
        "id": "task_achievement",
        "name": "Task Achievement",
        "band": 6.5,
        "band_reason": "Bài có overview và so sánh các nước, nhưng dùng từ chỉ mức tăng cho biểu đồ chỉ có một năm và chưa nêu số của Russia.",
        "strengths": [
          "Mở bài nêu đúng đại lượng và năm 2010.",
          "Có câu Overall nêu đặc điểm chính của biểu đồ."
        ],
        "improvements": [
          "Nêu số của Russia và mô tả chênh lệch thay cho xu hướng tăng."
        ]
      },
      {
        "id": "coherence_cohesion",
        "name": "Coherence and Cohesion",
        "band": 6.5,
        "band_reason": "Ý đi từ số lớn đến số nhỏ và có câu Overall, nhưng toàn bài dồn vào một đoạn.",
        "strengths": [
          "Câu Overall tóm tắt đặc điểm chính."
        ],
        "improvements": [
          "Tách mở bài và overview khỏi phần số liệu."
        ]
      },
      {
        "id": "lexical_resource",
        "name": "Lexical Resource",
        "band": 6,
        "band_reason": "Dùng đúng production capacity nhưng big increase of production vừa sai ngữ cảnh vừa thiếu chính xác.",
        "strengths": [
          "Dùng đúng estimated production capacity thay cho số lượng dài dòng."
        ],
        "improvements": [
          "Dùng a large gap in production capacity để nói về chênh lệch giữa các nước."
        ]
      },
      {
        "id": "grammatical_range_accuracy",
        "name": "Grammatical Range and Accuracy",
        "band": 6.5,
        "band_reason": "Các câu so sánh phần lớn dễ hiểu, nhưng một câu thừa động từ were sau produced.",
        "strengths": [
          "Cụm almost three times the figure for Russia diễn đạt so sánh rõ."
        ],
        "improvements": [
          "Bỏ were sau produced trong câu về Norway và Mexico."
        ]
      }
    ],
    "summary": "Bài đạt band 6.5 và có overview, nhưng nói về mức tăng dù biểu đồ chỉ có năm 2010, bỏ số của Russia và có một câu sai cấu trúc.",
    "suggestions": [
      "Bổ sung số ước tính của Russia và tách phần overview thành đoạn riêng.",
      "Dùng từ chỉ chênh lệch thay cho increase ở biểu đồ một năm."
    ],
    "next_steps": [
      "Luyện mô tả biểu đồ cột chỉ có một mốc thời gian.",
      "Rà lại các câu so sánh để tránh thừa động từ."
    ],
    "annotations": [
      {
        "criterion": "lexical_resource",
        "issue": "collocation_error",
        "quote": "a big increase of production",
        "explanation": "Biểu đồ chỉ có năm 2010 nên không thể kết luận sản lượng tăng; dùng a large gap in production capacity để nói về chênh lệch."
      },
      {
        "criterion": "grammatical_range_accuracy",
        "issue": "inappropriate_structure",
        "quote": "Norway and Mexico produced were considerably less",
        "explanation": "Thừa were sau produced. Viết Norway and Mexico produced considerably less."
      }
    ]
  },
  "meta": {
    "request_id": "req_01M23NT8MJW22AYX6FVT17F5XF",
    "service": "writing",
    "timing": {
      "downstream_ms": 41820,
      "gateway_overhead_ms": 184,
      "total_ms": 42004
    },
    "operation": "writing.task1.grade"
  }
}

Trường và ví dụ đầy đủ, kèm mọi lỗi có thể gặp: mở trang Writing Task 1.

Response: Envelope { data, meta } của AIHUB. data khớp hợp đồng chấm bài: overall_band chạy từ 0 đến 9 theo bội số 0.5, criteria luôn có đúng 4 phần tử theo thứ tự cố định (bắt đầu bằng task_response), kèm summary, suggestions, next_steps và annotations trích nguyên văn câu trong bài. meta cho request_id để báo hỗ trợ, service, operation và các số đo thời gian; correlation_id chỉ xuất hiện khi bạn gửi X-Correlation-Id.

{
  "data": {
    "overall_band": 7,
    "language": "vi",
    "criteria": [
      {
        "id": "task_response",
        "name": "Task Response",
        "band": 7,
        "band_reason": "Bài bàn cả hai quan điểm và kết luận ủng hộ đào tạo nghề với điều kiện được coi trọng ngang các môn học thuật; ví dụ minh họa còn khái quát.",
        "strengths": [
          "Nêu quan điểm cá nhân ở câu cuối thay vì để ngỏ.",
          "Câu kết nêu rõ điều kiện same status and the same faculty."
        ],
        "improvements": [
          "Thêm ví dụ cụ thể về một chương trình đào tạo nghề trong đại học."
        ]
      },
      {
        "id": "coherence_cohesion",
        "name": "Coherence and Cohesion",
        "band": 7,
        "band_reason": "Các ý nối theo trình tự rõ, nhưng toàn bài dồn vào một đoạn và câu Neither path is complete alone quá dài.",
        "strengths": [
          "Các câu nối trực tiếp từ lợi ích học thuật sang đào tạo nghề."
        ],
        "improvements": [
          "Tách phần học thuật và phần đào tạo nghề thành hai đoạn."
        ]
      },
      {
        "id": "lexical_resource",
        "name": "Lexical Resource",
        "band": 7,
        "band_reason": "Từ vựng học thuật phù hợp, nhưng turns that analysis into a specific craft là phép diễn đạt trừu tượng.",
        "strengths": [
          "Dùng chính xác vocational training và academic subject theo nghĩa của đề."
        ],
        "improvements": [
          "Nêu kỹ năng thực hành cụ thể thay cho specific craft."
        ]
      },
      {
        "id": "grammatical_range_accuracy",
        "name": "Grammatical Range and Accuracy",
        "band": 7,
        "band_reason": "Câu ghép và mệnh đề điều kiện dùng đúng, nhưng câu Neither path is complete alone chứa quá nhiều ý.",
        "strengths": [
          "Cấu trúc provided it carries the same status là câu chủ động phức đúng ngữ pháp."
        ],
        "improvements": [
          "Tách câu Neither path is complete alone thành hai câu."
        ]
      }
    ],
    "summary": "Bài đạt band 7.0, nêu rõ quan điểm và điều kiện trong kết luận. Cần ví dụ cụ thể hơn, chia đoạn và rút ngắn một câu dài.",
    "suggestions": [
      "Thêm ví dụ về chương trình đào tạo nghề trong đại học.",
      "Tách phần học thuật và đào tạo nghề thành các đoạn riêng."
    ],
    "next_steps": [
      "Viết lại bài với các đoạn riêng và một ví dụ thực tế cho quan điểm cá nhân."
    ],
    "annotations": [
      {
        "criterion": "lexical_resource",
        "issue": "imprecise_word_choice",
        "quote": "turns that analysis into a specific craft",
        "explanation": "Cách diễn đạt trừu tượng; nêu rõ đào tạo nghề giúp người học phát triển kỹ năng thực hành cụ thể."
      },
      {
        "criterion": "task_response",
        "issue": "underdeveloped_example",
        "quote": "provided it carries the same status and the same faculty as academic study",
        "explanation": "Điều kiện đã rõ nhưng cần một ví dụ về cách đại học trao vị thế tương đương cho đào tạo nghề."
      }
    ]
  },
  "meta": {
    "request_id": "req_01M23NT8MJW22AYX6FVT17F5XF",
    "service": "writing",
    "timing": {
      "downstream_ms": 41820,
      "gateway_overhead_ms": 184,
      "total_ms": 42004
    },
    "operation": "writing.task2.grade"
  }
}

Trường và ví dụ đầy đủ, kèm mọi lỗi có thể gặp: mở trang Writing Task 2.

Response: Envelope { data, meta } của AIHUB. data khớp hợp đồng chấm Speaking: scorability cho biết lượt nói có chấm được không, estimated_band gồm 5 tiêu chí mỗi tiêu chí là số chẵn hoặc nửa từ 0 đến 9, transcript cho nội dung đã nghe kèm số từ và thời lượng, relevance cho mức độ đúng chủ đề, fluency_metrics cho nhịp nói và ngừng, pronunciation_detail cho chất lượng từng từ và âm, language_analysis cho lỗi ngữ pháp cùng nâng cấp từ vựng, và feedback cho tóm tắt cùng kế hoạch cải thiện. meta cho request_id để báo hỗ trợ, service và operation.

{
  "data": {
    "test_type": "Practice",
    "question_id": "p1_do-you-enjoy-living-in-your-city-or-hometown",
    "scorability": {
      "is_scorable": true,
      "confidence": "high",
      "display_band": true,
      "message_vi": null
    },
    "estimated_band": {
      "overall": 6,
      "fluency_coherence": 6,
      "lexical_resource": 6.5,
      "grammatical_range_accuracy": 5.5,
      "pronunciation": 6
    },
    "transcript": {
      "text": "I live in a small town about thirty kilometres from the city.",
      "word_count": 12,
      "duration_seconds": 6.4
    },
    "relevance": {
      "on_topic": true,
      "score": 0.93,
      "feedback_vi": "Câu trả lời đi thẳng vào đề hỏi về quê hương."
    },
    "fluency_metrics": {
      "speech_rate_wpm": 112,
      "pause_count": 2,
      "mean_length_run_words": 6.1
    },
    "pronunciation_detail": {
      "summary": {
        "good_count": 9,
        "fair_count": 2,
        "poor_count": 1
      },
      "words": []
    },
    "language_analysis": {
      "grammar_errors": [],
      "vocabulary_upgrades": []
    },
    "feedback": {
      "summary_vi": "Lượt nói rõ ràng, tốc độ hơi nhanh ở câu cuối.",
      "strong_point_vi": "Nói đủ ý và tự nhiên.",
      "action_plan_vi": "Luyện ngắt hơi giữa các ý để tăng điểm trôi chảy."
    }
  },
  "meta": {
    "request_id": "req_01M23NT8MJW22AYX6FVT17F5XF",
    "service": "speaking",
    "operation": "speaking.grading",
    "timing": {
      "downstream_ms": 22140,
      "gateway_overhead_ms": 163,
      "total_ms": 22303
    }
  }
}

Trường và ví dụ đầy đủ, kèm mọi lỗi có thể gặp: mở trang Speaking multipart.

Response: Envelope { data, meta } của AIHUB. data khớp hợp đồng chấm Speaking: scorability cho biết lượt nói có chấm được không, estimated_band gồm 5 tiêu chí mỗi tiêu chí là số chẵn hoặc nửa từ 0 đến 9, transcript cho nội dung đã nghe kèm số từ và thời lượng, relevance cho mức độ đúng chủ đề, fluency_metrics cho nhịp nói và ngừng, pronunciation_detail cho chất lượng từng từ và âm, language_analysis cho lỗi ngữ pháp cùng nâng cấp từ vựng, và feedback cho tóm tắt cùng kế hoạch cải thiện. meta cho request_id để báo hỗ trợ, service và operation.

{
  "data": {
    "test_type": "Practice",
    "question_id": "p1_do-you-enjoy-living-in-your-city-or-hometown",
    "scorability": {
      "is_scorable": true,
      "confidence": "high",
      "display_band": true,
      "message_vi": null
    },
    "estimated_band": {
      "overall": 6,
      "fluency_coherence": 6,
      "lexical_resource": 6.5,
      "grammatical_range_accuracy": 5.5,
      "pronunciation": 6
    },
    "transcript": {
      "text": "I live in a small town about thirty kilometres from the city.",
      "word_count": 12,
      "duration_seconds": 6.4
    },
    "relevance": {
      "on_topic": true,
      "score": 0.93,
      "feedback_vi": "Câu trả lời đi thẳng vào đề hỏi về quê hương."
    },
    "fluency_metrics": {
      "speech_rate_wpm": 112,
      "pause_count": 2,
      "mean_length_run_words": 6.1
    },
    "pronunciation_detail": {
      "summary": {
        "good_count": 9,
        "fair_count": 2,
        "poor_count": 1
      },
      "words": []
    },
    "language_analysis": {
      "grammar_errors": [],
      "vocabulary_upgrades": []
    },
    "feedback": {
      "summary_vi": "Lượt nói rõ ràng, tốc độ hơi nhanh ở câu cuối.",
      "strong_point_vi": "Nói đủ ý và tự nhiên.",
      "action_plan_vi": "Luyện ngắt hơi giữa các ý để tăng điểm trôi chảy."
    }
  },
  "meta": {
    "request_id": "req_01M23NT8MJW22AYX6FVT17F5XF",
    "service": "speaking",
    "operation": "speaking.grading",
    "timing": {
      "downstream_ms": 22140,
      "gateway_overhead_ms": 163,
      "total_ms": 22303
    }
  }
}

Trường và ví dụ đầy đủ, kèm mọi lỗi có thể gặp: mở trang Speaking JSON-by-URL.