Cloudflare: Clef Omni
Cloudflare Clef Omni é um modelo multimodal de decisão com uma arquitetura de base MoE de 30B parâmetros totais e 3B ativos. Avalia texto, estado estruturado e conteúdos multimédia fornecidos em função de perguntas tipadas, devolvendo probabilidades e decisões delimitadas. A sua saída é uma escolha, uma probabilidade de verdadeiro ou uma pontuação ordenada, em vez de prosa gerada.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
Cloudflare Clef Omni é o modelo multimodal de mistura de especialistas da família de decisão Clef. É obtido por pós-treino da arquitetura de base de compreensão Qwen3-Omni-30B-A3B-Instruct, com 30B parâmetros totais e 3B ativos. A Cloudflare acrescenta uma cabeça de esquema conjunto que encaminha a evidência para as perguntas pedidas e pontua as respetivas opções permitidas em conjunto. O resultado é uma decisão tipada com probabilidades, em vez de uma explicação gerada, uma transcrição ou uma saída de voz.
Prepare duas partes principais: um estado que descreva a situação e um mapeamento de perguntas com nome. O estado pode ser texto ou JSON estruturado, e as entradas nativas do modelo também incluem imagens, áudio e vídeo. Cada pergunta indica o que decidir e quais as respostas permitidas. Mantenha os identificadores estáveis para que uma aplicação possa associar cada resposta devolvida à pergunta original. Descrições claras das opções dão significado a uma categoria; uma designação curta e ambígua pode, de outro modo, ocultar a distinção de que o fluxo de trabalho realmente precisa.
O formato do registo tem três tipos de pergunta. Uma pergunta noul consulta uma condição de verdadeiro/falso e devolve a probabilidade de ser verdadeira. Uma pergunta choice define opções com nome e devolve uma opção selecionada, probabilidades por opção e um valor de confiança separado. Uma pergunta score define critérios ordenados com índices a partir de zero e devolve uma pontuação ponderada pela probabilidade, uma legenda e as probabilidades. A pontuação pode ser fracionária porque reflete uma distribuição por níveis. Uma decisão é, por isso, mais rica do que uma única etiqueta, mantendo-se delimitada pelo esquema fornecido.
Para uma revisão visual, forneça uma imagem clara e a condição a avaliar. Um exemplo é um registo de instalação com perguntas sobre se a etiqueta de identificação está visível, qual das categorias de estado definidas se aplica e se a evidência é suficiente para revisão. Mantenha as observações separadas: uma etiqueta estar visível é uma pergunta diferente de uma instalação parecer completa. A saída pode ajudar uma aplicação a encaminhar o registo ou a assinalar uma condição que exige revisão; não realiza, por si só, uma inspeção, não altera um registo nem gera um relatório escrito.
Para áudio e vídeo, centre as perguntas na evidência que o excerto fornecido pode sustentar. Uma revisão prática de equipamento pode incluir uma fotografia, uma gravação e um vídeo curto, perguntando se um som especificado está presente ou se um componente se move de forma visível. O fabricante descreve o processamento da faixa sonora de um vídeo em conjunto com os seus fotogramas quando todos os vídeos do registo têm som. Preserve a relação entre os conteúdos multimédia e o estado escrito e evite pedir ao modelo que classifique um evento fora do intervalo anexado.
O perfil alojado do fabricante indica um contexto de 64 000 tokens e uma a 64 perguntas. Aceita até quatro imagens, quatro excertos de áudio e dois vídeos, com cada excerto de áudio limitado a 300 segundos e cada vídeo a 60 segundos. Estes são os limites da interface documentada do produtor. Os conteúdos multimédia e as perguntas ocupam contexto; um excesso de conteúdos multimédia pode fazer falhar o pedido, enquanto um estado de texto longo pode ser truncado para caber. Coloque a evidência decisiva num registo focado e prepare as perguntas antes de gastar a janela com histórico sem relação com a tarefa.
A interface alojada do fabricante recebe conteúdos multimédia incorporados, em vez de ligações remotas. As imagens PNG, JPEG ou WebP estão limitadas a 4 MiB e 16 megapíxeis cada, com um orçamento total de imagens descodificadas de 8 MiB. Cada excerto de áudio está limitado a 8 MiB e 300 segundos; cada vídeo, a 16 MiB e 60 segundos. O áudio e o vídeo, em conjunto, podem totalizar no máximo 16 MiB descodificados, e os vídeos são amostrados a dois fotogramas por segundo. Estes limites pertencem a essa interface do produtor; o codificador de pesos abertos aceita representações locais adicionais. A capacidade de áudio da arquitetura de base de compreensão não significa que este modelo de decisão produza áudio: os seus componentes de geração de voz não são utilizados na pontuação de decisões.
Para encaminhamento de suporte ou de fluxos de trabalho, defina categorias e critérios ordenados a partir das regras operacionais reais. Um registo de pedido de suporte pode perguntar que equipa o deve tratar, se o impacto é urgente e qual o nível de gravidade que melhor corresponde à evidência. A saída observável é um conjunto de respostas tipadas identificadas pelos nomes dessas perguntas. Reveja toda a distribuição de probabilidades quando as categorias estiverem próximas e defina explicitamente como a aplicação trata os casos incertos. Uma probabilidade elevada é uma avaliação do modelo sobre a evidência fornecida, não uma prova de que a condição foi verificada de forma independente.
Ao examinar um resultado, conserve em conjunto o estado, o esquema de perguntas e as respostas devolvidas. Verifique se as opções abrangem a situação real, se as suas descrições se sobrepõem e se foi omitida ou truncada evidência importante. Se uma etapa posterior precisar de uma explicação escrita, pode utilizar a decisão e o material de origem como entrada de uma etapa de redação separada. O papel útil de Clef Omni é pontuar alternativas definidas a partir de evidência multimodal, para que a ação seguinte possa ser escolhida com entradas e saídas claras e inspecionáveis.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-omni
cloudflare/clef-omniIntrodução
Cloudflare Clef Omni é um modelo multimodal de decisão com uma arquitetura de base MoE de 30B parâmetros totais e 3B ativos. Avalia texto, estado estruturado e conteúdos multimédia fornecidos em função de perguntas tipadas, devolvendo probabilidades e decisões delimitadas. A sua saída é uma escolha, uma probabilidade de verdadeiro ou uma pontuação ordenada, em vez de prosa gerada.
- Entradas aceites
- Texto · Imagens
- Resultados
- decisions
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · System One POST /v1/systemone
- Entrada
text,image- Saída
decisions- Formato de saída
- json
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites cloudflare/clef-omni | Predefinição— |
Campoprovider | Tiposchema | RequisitoOpcional | Valores e limites | Predefinição— |
Campoquestions | Tipoobject | RequisitoObrigatório | Valores e limites | Predefinição— |
Camposession_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campostate | Tiposchema | RequisitoObrigatório | Valores e limites | Predefinição— |
Campotrace | Tiposchema | RequisitoOpcional | Valores e limites | Predefinição— |
Campouser | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campoquestions.<id>.type | Tipostring | RequisitoObrigatório | Valores e limites noul, choice, score | Predefinição— |
Campoquestions.<id>.instructions | Tipostring|object|array | RequisitoObrigatório | Valores e limites | Predefinição— |
Campoquestions.<id>.criteria | Tipoobject|array | RequisitoOpcional | Valores e limites Condições: choice/score: obrigatório; noul: opcional. Os critérios de choice são um objeto; score é uma matriz com minItems1. | Predefinição— |
Campoquestions.<id>.criteria.true | Tipostring|object|array | RequisitoObrigatório | Valores e limites Aplica-se quando: Objeto de critérios noul fornecido | Predefinição— |
Campoquestions.<id>.criteria.false | Tipostring|object|array | RequisitoObrigatório | Valores e limites Aplica-se quando: Objeto de critérios noul fornecido | Predefinição— |
Combinações de materiais de entrada
noul · Obrigatório: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obrigatório: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obrigatório: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, state, questions |
Parâmetromaterial_types | Contratotext, image |
Parâmetrooptional_controls | Contratoprovider, session_id, trace, user |
Parâmetromultimodal_input_binding | ContratoUtilize apenas a representação exata declarada de estado/documento. A capacidade de imagens do fabricante, por si só, não estabelece uma forma aceite de transmitir imagens específica do modelo. |
Ciclo de vida: synchronous
Envie o ID exato do modelo e conserve a resposta nativa completa.
Tarifários
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas Ailoot
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Tokens de contexto, mais de | Tokens de contexto, até ao limite inclusive | Custo |
|---|---|---|---|---|
| ConfiguraçãoTarifas base dos tokens | Tabela de tarifasTarifa base | Tokens de contexto, mais de— | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo Entrada · Tokens de entrada $0.0003 / 1K tokens Saída · Tokens de saída $0 / 1K tokens Entrada · Leitura da cache — / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens |
| ConfiguraçãoEscalão 1 por comprimento do pedido | Tabela de tarifas— | Tokens de contexto, mais de0 | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo Entrada · Tokens de entrada $0.0003 / 1K tokens Saída · Tokens de saída $0 / 1K tokens Entrada · Leitura da cache — / 1K tokens Entrada · Escrita na cache — / 1K tokens Entrada · Escrita na cache, 1 hora — / 1K tokens |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · System One
{
"model": "cloudflare/clef-omni",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cloudflare/clef-omni'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Receber e guardar os resultados
Ailoot Ultra · System One
json
Guardar todos os resultados concluídos
Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.
É conservada cada resposta fornecida a um ID de pergunta, com o respetivo tipo exato, valor noul/choice/score, confiança, probabilidades e legenda. O JSON original completo é armazenado e devolvido apenas após a liquidação.
Se for necessário verificar a resposta original
Conserve a operação original e a resposta completa/parcial; não repita o POST.
Campos da resposta
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Campoid | Tipostring |
Campoprovider | Tipostring |
Campoanswers.<id>.type | Tipostring |
Campoanswers.<id>.noul | Tiponumber |
Campoanswers.<id>.choice | Tipostring |
Campoanswers.<id>.score | Tiponumber |
Campoanswers.<id>.confidence | Tiponumber |
Campoanswers.<id>.probabilities | Tipoobject |
Campoanswers.<id>.legend | Tipoobject |
Campousage.input_tokens | Tipointeger |
Campousage.output_tokens | Tipointeger |
Campousage.cost | Tiponumber |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoCampo obrigatório, representação ou valor inválido | Passo seguinteCorrija o campo indicado no pedido. |
Aliases
Aliases do modelo
Ailoot Ultra cloudflare/clef-omni
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Cloudflare: Clef Omni
- Que entradas e resultados estão disponíveis?
POST /v1/systemone·cloudflare/clef-omni:text,image→decisions- Que campos utiliza o pedido?
POST /v1/systemone·cloudflare/clef-omni:model,provider,questions,session_id,state,trace,user