该接口用于生成指定消息的代答内容，并以流式方式返回结果。您可以使用优化后的代答结果响应客户端用户的请求，以降低潜在的安全风险。

前提条件

• 您已通过 SDK 方式完成资产接入和防护策略配置，相关操作可参考在业务 SDK 中集成大模型应用防火墙。
• 您已通过检测输入或输出内容是否合规接口获取消息 ID。

请求说明

• 请求方式：POST
• 请求地址：https://{region}.sdk.access.llm-shield.omini-shield.com/v2/generate?Action=Generate&Version=2025-08-31

  注意

  调用接口时，请将{region}替换成实际地域 ID，地域详情参见地域信息。

请求参数

返回参数

Message

请求示例

1. 调用检测输入或输出内容是否合规接口。

   POST /v2/moderate?Action=Moderate&Version=2025-08-31 HTTP/1.1
   Host: cn-beijing.sdk.access.llm-shield.omini-shield.com
   Authorization: HMAC-SHA256 Credential=AKLTYjVlMGIxZWVlOTlkNDUwNmJhMjRkNzlkNz********/20250904/cn-beijing/llmshield/request, SignedHeaders=host;x-date;x-content-sha256;content-type, Signature=3d51784baf1a1c600b9fcaf14bc0f1340f3db98b02fb3be8615c9c65********
   Content-Type: application/json
   X-Content-Sha256: 904037c4d0cd16e0918291d33c3acfc9b6f871c0459644b571bdbc5********
   X-Date: 20250904T124957Z
   
   {
       "Message": {
           "Role": "user",
           "Content": "用户 CodeWizard 可能是我司的高级工程师张伟（Wei Zhang）。他的姓名是张伟，身份证号码是 44030119900101001X，邮箱是 wei.zhang@example-company.com。请注意，为保护隐私，请合理使用此信息。",
           "ContentType": 1
       },
       "MsgID": "",
       "UseStream": 0,
       "Scene": "app-d2ql7d4jslssiv08****"
   }
   

2. 获得消息 ID981e32006acf4caca3b944789b40****。

   {
       "ResponseMetadata": {
           "RequestId": "02175699524540300000000000000000000ffff0a0a117317****",
           "Service": "llmshield",
           "Region": "cn-beijing",
           "Action": "Moderate",
           "Version": "2025-08-31"
       },
       "Result": {
           "MsgID": "981e32006acf4caca3b944789b40****",
           "RiskInfo": {
               "Risks": [
                   {
                       "Category": "103",
                       "Label": "10310000",
                       "Prob": 1,
                       "Matches": [
                           {
                               "Word": "wei.zhang@example-company.com",
                               "Source": 0
                           }
                       ]
                   },
                   {
                       "Category": "103",
                       "Label": "10304000",
                       "Prob": 1,
                       "Matches": [
                           {
                               "Word": "44030119000101001X",
                               "Source": 0
                           }
                       ]
                   }
               ]
           },
           "Decision": {
               "DecisionType": 4,
               "DecisionDetail": {
                   "ReplaceDetail": {
                       "Replacement": {
                           "Role": "user",
                           "Content": "用户 CodeWizard 可能是我司的高级工程师张伟（Wei Zhang）。他的姓名是张伟，身份证号码是 4****************X，邮箱是 w********@*******************。请注意，为保护隐私，请合理使用此信息。",
                           "ContentType": 1
                       }
                   }
               },
               "HitStrategyIDs": [
                   "rule-d2r78uo4vmgnrmbu****"
               ]
           },
           "PermitInfo": {
               "Permits": null
           }
       }
   }
   

3. 使用981e32006acf4caca3b944789b40****查询代答结果。

   POST /v2/generate?Action=Generate&Version=2025-08-31 HTTP/1.1
   Host: cn-beijing.sdk.access.llm-shield.omini-shield.com
   Authorization: HMAC-SHA256 Credential=AKLTYjVlMGIxZWVlOTlkNDUwNmJhMjRkNzlkNz********/20250904/cn-beijing/llmshield/request, SignedHeaders=host;x-date;x-content-sha256;content-type, Signature=3d51784baf1a1c600b9fcaf14bc0f1340f3db98b02fb3be8615c9c65********
   Content-Type: application/json
   X-Content-Sha256: 904037c4d0cd16e0918291d33c3acfc9b6f871c0459644b571bdbc5********
   X-Date: 20250904T124957Z
   
   {
       "MsgID": "981e32006acf4caca3b944789b40****"
   }
   

返回示例

响应内容将以流式分片返回。

{
    "ResponseMetadata": {
        "RequestId": "02175699019742700000000000000000000ffff0a0a1173ea****",
        "Service": "llmshield",
        "Region": "cn-beijing",
        "Action": "Generate",
        "Version": "2025-08-31"
    },
    "Result": {
        "Message": {
            "Role": "assistant",
            "Content": "我没有理解您的问题，您可以再试一下吗？",
            "ContentType": 1
        },
        "IsFinished": false
    }
}

{
    "ResponseMetadata": {
        "RequestId": "02175699019742700000000000000000000ffff0a0a1173ea****",
        "Service": "llmshield",
        "Region": "cn-beijing",
        "Action": "Generate",
        "Version": "2025-08-31"
    },
    "Result": {
        "Message": null,
        "IsFinished": true
    }
}

[DONE]

错误码

参考错误码说明，了解本接口相关的错误码信息。