AI Guardrails:Envio de tarefas assíncronas de OCR de imagens

Descrição da operação assíncrona

Operação: /green/image/asyncscan

Use esta operação para enviar tarefas assíncronas de moderação de imagens. Para saber como construir uma solicitação HTTP, consulte Estrutura da solicitação. Também é possível usar uma solicitação HTTP pré-construída. Para mais informações, veja Visão geral do SDK.

• Billing method:

  Esta é uma operação de API paga. Para mais detalhes sobre faturamento, consulte Preços do Content Moderation.

• Response timeout:

  O tempo máximo de detecção para uma solicitação síncrona é de 6 segundos. Se a detecção não for concluída dentro desse prazo, um erro de timeout será retornado. Se resultados em tempo real não forem necessários, use a detecção assíncrona. Caso contrário, prefira a detecção síncrona, pois sua chamada de API é mais simples. Para essas chamadas, defina o tempo limite como 6 segundos.

• Returned results:

  Tarefas de detecção assíncrona não retornam resultados em tempo real. É necessário usar callback ou polling para recuperar os resultados, que ficam armazenados por até uma hora.

  • Ative a notificação por callback para obter resultados de moderação: ao enviar tarefas assíncronas, especifique uma URL de callback no parâmetro callback da solicitação para receber os resultados. Para mais informações sobre o parâmetro callback, consulte Parâmetros da solicitação.

  • Consulte os resultados de moderação em intervalos regulares: não é necessário definir o parâmetro callback ao enviar tarefas assíncronas. Após o envio, chame a operação /green/video/results para consultar os resultados. Para mais detalhes sobre essa operação, veja Descrição da operação /green/image/results.

• Limits on images:

  • A URL da imagem deve usar o protocolo HTTP ou HTTPS.

  • Formatos de imagem suportados: PNG, JPG, JPEG, BMP, GIF e WEBP.

  • O tamanho da imagem não pode exceder 20 MB, tanto para chamadas síncronas quanto assíncronas .

  • A imagem deve ser baixada em até 3 segundos. Se o download exceder esse tempo, um erro de timeout de download será retornado.

  • Para melhor desempenho, recomenda-se que a resolução da imagem seja de pelo menos 256x256 pixels. Resoluções inferiores podem afetar a precisão da detecção.

  • O tempo de resposta da API de detecção de imagens depende do tempo de download da imagem. Garanta que o serviço de armazenamento onde a imagem está hospedada seja estável e confiável. Para obter o melhor desempenho, use o Object Storage Service (OSS) da Alibaba Cloud ou uma Content Delivery Network (CDN).

Limite de QPS

O limite de consultas por segundo (QPS) para esta API é de 10 por usuário. Exceder esse limite aciona o throttling, o que pode impactar seus negócios. Planeje suas chamadas adequadamente.

Parâmetros da solicitação

Parâmetros de resposta

Exemplos

http(s)://[Endpoint]/green/image/asyncscan
&<Common request parameters>
{
    "scenes": [
        "ocr"
    ],
    "tasks": [
        {
            "dataId": "test_data_xxxx",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

{
    "code": 200,
    "msg": "OK",
    "requestId": "92AD868A-F5D2-4AEA-96D4-E1273B8E074C",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "test_data_xxxx",
            "taskId": "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

Descrição da operação /green/image/results

Operação: /green/image/results

Use esta operação para consultar resultados assíncronos de OCR. Para saber como construir uma solicitação HTTP, consulte Estrutura da solicitação. Também é possível usar uma solicitação HTTP pré-construída. Para mais informações, veja Visão geral do SDK.

• Billing method:

  Esta operação de API é gratuita.

• Response timeout:

  Defina o intervalo de polling para 30 segundos, ou seja, consulte o resultado 30 segundos após enviar uma tarefa de detecção assíncrona. O resultado fica armazenado por até uma hora e é descartado se não for recuperado nesse período.

Limite de QPS

O limite de consultas por segundo (QPS) para esta API é de 10 por usuário. Exceder esse limite aciona o throttling, o que pode impactar seus negócios. Planeje suas chamadas adequadamente.

Parâmetros da solicitação

Parâmetros de resposta

Exemplos

http(s)://[Endpoint]green/image/results
&<Common request parameters>
[
    "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****"
]

{
    "code": 200,
    "data": [
        {
            "code": 200,
            "dataId": "test_data_xxxx",
            "extras": {

            },
            "msg": "OK",
            "results": [
                {
                    "label": "ocr",
                    "ocrData": [
                        "This topic describes how to call an operation to submit asynchronous image moderation tasks."
                    ],
                    "ocrLocations": [
                        {
                            "h": 19,
                            "text": "This topic describes how to call an operation to submit asynchronous image moderation tasks.",
                            "w": 362,
                            "x": 31,
                            "y": 11
                        }
                    ],
                    "rate": 99.91,
                    "scene": "ocr",
                    "suggestion": "review"
                }
            ],
            "taskId": "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ],
    "msg": "OK",
    "requestId": "992C7849-AA45-4055-8F82-8D44D64C15E3"
}