AI Guardrails:Query information about face images

Request parameters

All parameters in the request body are required.

Example

The following example queries face information for a person by specifying a person ID and two face IDs. Reuse the client instance across requests to improve moderation performance and avoid repeated connection overhead.

package main

import (
    "encoding/json"
    "fmt"
    "os"
    "strconv"

    "github.com/aliyun/alibaba-cloud-sdk-go/services/green"
)

func main() {
    // Initialize the client once and reuse it across requests.
    // Read credentials from environment variables to avoid hardcoding sensitive values.
    client, err := green.NewClientWithAccessKey(
        "cn-shanghai",
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
        os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
    )
    if err != nil {
        fmt.Println(err.Error())
        return
    }

    // Specify the person ID and the face IDs to query.
    content, _ := json.Marshal(
        map[string]interface{}{
            "personId": "<your-person-id>",
            "faceIds":  []string{"<face-id-1>", "<face-id-2>"},
        },
    )

    request := green.CreateGetFacesRequest()
    request.SetContent(content)

    response, err := client.GetFaces(request)
    if err != nil {
        fmt.Println(err.Error())
        return
    }
    if response.GetHttpStatus() != 200 {
        fmt.Println("Request failed. HTTP status code: " + strconv.Itoa(response.GetHttpStatus()))
        return
    }

    fmt.Println(response.GetHttpContentString())
}

Replace the placeholders before running the example:

Response

A successful request returns HTTP status code 200. The response body contains the face IDs and image file paths associated with the specified person. For the complete response schema, see API operation for querying information about face images.