Cloudflare: Clef Flash
Cloudflare Clef Flash é o modelo de decisão Clef mais pequeno, de 9B parâmetros, concebido para classificação rápida e escolhas em fluxos de trabalho. Avalia texto, estado estruturado e entradas visuais em função de perguntas com nome, devolvendo probabilidades por opção, uma categoria selecionada ou uma pontuação ordenada, sem gerar prosa.
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 Flash é o modelo de decisão mais pequeno da família Clef, criado por pós-treino de Qwen3.5-9B com o seu codificador visual. Uma cabeça de esquema conjunto lê a evidência da entrada e pontua as respostas permitidas para cada pergunta pedida numa única passagem de inferência. O seu papel é produzir classificações e decisões delimitadas num fluxo de trabalho. A saída é um resultado tipado com probabilidades, em vez de uma resposta de conversação que uma aplicação tenha de interpretar como categoria.
Descreva a situação num estado de texto ou JSON e defina as perguntas separadamente. Uma pergunta precisa de um nome estável, um tipo e uma instrução clara; as perguntas de categoria ou de pontuação também definem os critérios permitidos. Para uma mensagem de suporte, uma pergunta pode classificar o problema, outra avaliar a urgência e outra identificar se falta ao registo informação necessária para a etapa seguinte. Mantenha no estado as palavras reais do cliente, o histórico relevante e as regras operacionais, para que a decisão esteja ligada à evidência.
Os três tipos de pergunta respondem a necessidades diferentes. Um resultado noul é a probabilidade de uma condição de verdadeiro/falso se verificar. Um resultado choice identifica uma opção com nome e inclui as probabilidades das alternativas, bem como um valor de confiança. Um resultado score avalia critérios ordenados e devolve a sua pontuação ponderada pela probabilidade, a legenda e a distribuição. Defina deliberadamente a ordem de uma pontuação: passar de «Não é necessária nenhuma ação» para «Revisão imediata» é diferente de um conjunto não ordenado de etiquetas temáticas.
Para encaminhamento rápido, descreva as categorias através das ações ou dos limites de responsabilidade que realmente as distinguem. Um exemplo útil é um pedido com opções de acesso à conta, falha técnica, questão sobre documentação e outro, com cada opção explicada. O resultado do modelo pode ser passado à regra de encaminhamento de uma aplicação. Uma distribuição próxima entre falha técnica e acesso à conta constitui evidência útil de ambiguidade; decida explicitamente como o fluxo de trabalho trata esses casos, em vez de assumir que a etiqueta selecionada é um diagnóstico confirmado.
Para classificação visual, forneça uma imagem legível e uma condição que a imagem possa sustentar. Uma revisão de recibos pode perguntar se o total é legível e escolher entre categorias definidas de qualidade documental. Não deve pedir um novo total arbitrário como se o modelo fosse um serviço de extração ou redação sem restrições. A interface de pesos abertos do fabricante também aceita matrizes de fotogramas de vídeo. Preserve a ligação entre os fotogramas e o estado escrito e faça perguntas sobre eventos ou condições visíveis nesse material.
A referência atual da interface alojada do fabricante indica um contexto de 24 576 tokens, até 64 perguntas e até quatro imagens incorporadas. As imagens PNG, JPEG ou WebP estão limitadas a 4 MiB e 16 megapíxeis cada, com um total descodificado de 8 MiB; o corpo completo do pedido está limitado a 13 MiB e não são aceites ligações remotas para imagens. As definições das perguntas e os conteúdos multimédia consomem espaço de entrada, e texto longo pode ser truncado para caber. Coloque a evidência decisiva num estado compacto. A Cloudflare documenta que a redução do contexto alojado não alterou os pesos publicados, pelo que a janela alojada e a configuração de pesos abertos continuam a ser distintas.
A saída restringida do modelo torna-o útil para verificações repetidas de políticas ou fluxos de trabalho. Por exemplo, defina perguntas separadas sobre se um registo cumpre as regras de completude estabelecidas e qual a categoria de acompanhamento aplicável. Mantenha os critérios explícitos e inclua uma opção para casos que as categorias não abranjam, quando isso fizer parte do desenho do fluxo de trabalho. As probabilidades pontuam as opções fornecidas; não demonstram que essas opções constituem uma descrição completa de todas as situações reais.
Conserve em conjunto o estado, o esquema e a resposta devolvida. Quando um resultado for surpreendente, examine se um critério é ambíguo, se faltou uma entrada decisiva ou se foi cortado texto relevante. Compare as avaliações do modelo com casos revistos da tarefa real antes de escolher limiares para ações automáticas. O posicionamento de Clef Flash como modelo mais pequeno e de decisão rápida não substitui a verificação do custo de uma decisão de encaminhamento incorreta para o fluxo de trabalho.
Utilize o resultado tipado como entrada da etapa seguinte da aplicação. O modelo não executa essa etapa nem escreve a sua explicação posterior. Se o utilizador precisar de um relatório, mantenha a decisão e a evidência de origem disponíveis para um processo de redação separado. O artefacto útil de Clef Flash é uma resposta inspecionável para cada pergunta com nome, com a informação de probabilidade necessária para aplicar as regras do fluxo de trabalho.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashIntrodução
Cloudflare Clef Flash é o modelo de decisão Clef mais pequeno, de 9B parâmetros, concebido para classificação rápida e escolhas em fluxos de trabalho. Avalia texto, estado estruturado e entradas visuais em função de perguntas com nome, devolvendo probabilidades por opção, uma categoria selecionada ou uma pontuação ordenada, sem gerar prosa.
- 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-flash | 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.000076 / 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.000076 / 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-flash",
"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-flash'
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-flash
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Cloudflare: Clef Flash
- Que entradas e resultados estão disponíveis?
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- Que campos utiliza o pedido?
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user