> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# omni-moderation-latest Moderação de conteúdo

>  - Suporta moderação de conteúdo de texto, imagem e misto texto+imagem
- Compatível com entrada de texto único, array de textos e array de blocos de conteúdo
- Imagens suportam URLs públicas e Data URIs em base64 

Use `omni-moderation-latest` para realizar a moderação de segurança do conteúdo de entrada. Este modelo pertence à Série de Moderação e não faz parte das séries de geração de imagem, vídeo ou áudio.

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://gccai.heqingsong.uk/v1/moderations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "omni-moderation-latest",
      "input": [
        {
          "type": "text",
          "text": "Por favor, modere se esta imagem está em conformidade"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://gccai.heqingsong.uk/_gccai/cdn/files/1779955589195-wh950j4imqd.jpeg"
          }
        }
      ],
      "stream": false
    }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://gccai.heqingsong.uk/v1/moderations"

  payload = {
      "model": "omni-moderation-latest",
      "input": [
          {
              "type": "text",
              "text": "Por favor, modere se esta imagem está em conformidade"
          },
          {
              "type": "image_url",
              "image_url": {
                  "url": "https://gccai.heqingsong.uk/_gccai/cdn/files/1779955589195-wh950j4imqd.jpeg"
              }
          }
      ],
      "stream": False
  }

  headers = {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
  }

  response = requests.post(url, json=payload, headers=headers)

  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const url = "https://gccai.heqingsong.uk/v1/moderations";

  const payload = {
    model: "omni-moderation-latest",
    input: [
      {
        type: "text",
        text: "Por favor, modere se esta imagem está em conformidade",
      },
      {
        type: "image_url",
        image_url: {
          url: "https://gccai.heqingsong.uk/_gccai/cdn/files/1779955589195-wh950j4imqd.jpeg",
        },
      },
    ],
    stream: false,
  };

  const headers = {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  };

  fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload),
  })
    .then((response) => response.json())
    .then((data) => console.log(data))
    .catch((error) => console.error("Error:", error));
  ```
</RequestExample>

## Modelos suportados

| Modelo                   | Descrição                             | Entradas suportadas               |
| ------------------------ | ------------------------------------- | --------------------------------- |
| `omni-moderation-latest` | Modelo geral de moderação de conteúdo | Texto, imagem, misto texto+imagem |

## Authorizations

<ParamField header="Authorization" type="string" required>
  Todos os endpoints requerem autenticação via Bearer Token.

  Obter uma API Key:

  Acesse a [página de gerenciamento de API Key](https://gccai.heqingsong.uk/keys) para obter sua API Key.

  Adicione o seguinte cabeçalho à requisição:

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## Body

<ParamField body="model" type="string" required>
  Nome do modelo de moderação.

  * `omni-moderation-latest` - Modelo geral de moderação de conteúdo
</ParamField>

<ParamField body="input" type="string | string[] | object[]" required>
  Conteúdo a ser moderado. Suporta texto simples, array de textos ou array de blocos de conteúdo.

  Os blocos de conteúdo podem incluir:

  * `text` - Bloco de conteúdo de texto
  * `image_url` - Bloco de conteúdo de URL de imagem
</ParamField>

<ParamField body="stream" type="boolean" default="false">
  Indica se a resposta deve ser retornada em streaming.

  * `false`: Resposta não-streaming (padrão; único valor suportado no momento, `true` não é suportado)
</ParamField>

## Modos de requisição input

### Misto texto + imagem

```json theme={null}
{
  "model": "omni-moderation-latest",
  "input": [
    {
      "type": "text",
      "text": "Por favor, modere se esta imagem está em conformidade"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://gccai.heqingsong.uk/_gccai/cdn/files/1779955589195-wh950j4imqd.jpeg"
      }
    }
  ],
  "stream": false
}
```

### Texto simples (único)

```json theme={null}
{
  "model": "omni-moderation-latest",
  "input": "I want to kill someone",
  "stream": false
}
```

### Texto simples (array)

```json theme={null}
{
  "model": "omni-moderation-latest",
  "input": [
    "hello",
    "I hate you"
  ],
  "stream": false
}
```

### Apenas imagem (URL de imagem)

```json theme={null}
{
  "model": "omni-moderation-latest",
  "input": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://gccai.heqingsong.uk/_gccai/cdn/files/1779955589195-wh950j4imqd.jpeg"
      }
    }
  ],
  "stream": false
}
```

### Apenas imagem (Data URI base64)

```json theme={null}
{
  "model": "omni-moderation-latest",
  "input": [
    {
      "type": "image_url",
      "image_url": {
        "url": "data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUgAA..."
      }
    }
  ],
  "stream": false
}
```

## Observações

1. Quando `input` é um array de blocos de conteúdo, cada elemento usa `type` para distinguir o tipo de conteúdo.
2. Para moderação de imagens, prefira URLs publicamente acessíveis. Se usar base64, siga o formato padrão Data URI: `data:image/{format};base64,{data}`.
3. Salvo necessidade específica, mantenha `stream: false` de forma consistente.