Cloudflare: Clef Flash
Cloudflare Clef Flash es el modelo de decisión Clef más pequeño, de 9B, diseñado para clasificaciones rápidas y elecciones en flujos de trabajo. Evalúa texto, estado estructurado y entradas visuales frente a preguntas con nombre, y devuelve probabilidades por opción, una categoría seleccionada o una puntuación ordenada sin generar prosa.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Cloudflare Clef Flash es el modelo de decisión más pequeño de la familia Clef, creado mediante postentrenamiento de Qwen3.5-9B con su codificador de visión. Un cabezal de esquema conjunto lee la evidencia de la entrada y puntúa las respuestas permitidas de cada pregunta solicitada en una única pasada hacia delante. Su función es producir clasificaciones y decisiones acotadas dentro de un flujo de trabajo. La salida es un resultado tipado con probabilidades, en lugar de una respuesta conversacional que la aplicación tenga que interpretar como una categoría.
Describe la situación en un estado de texto o JSON y define las preguntas por separado. Una pregunta necesita un nombre estable, un tipo y una instrucción clara; las preguntas de categoría o de puntuación definen además sus criterios permitidos. Para un mensaje de soporte, una pregunta puede clasificar la incidencia, otra puede valorar la urgencia y otra puede determinar si al registro le falta información necesaria para el siguiente paso. Mantén en el estado la redacción real del cliente, el historial pertinente y las normas de funcionamiento para que la decisión quede ligada a la evidencia.
Los tres tipos de pregunta responden a necesidades distintas. Un resultado noul es la probabilidad de que se cumpla una condición de verdadero/falso. Un resultado de elección identifica una opción con nombre e incluye las probabilidades de las alternativas más un valor de confianza. Un resultado de puntuación evalúa criterios ordenados y devuelve su puntuación ponderada por probabilidad, la leyenda y la distribución. Define el orden de una puntuación de forma deliberada: pasar de «No se requiere ninguna acción» a «Revisión inmediata» es distinto de un conjunto no ordenado de etiquetas temáticas.
Para un enrutamiento rápido, describe las categorías mediante las acciones o los límites de responsabilidad que realmente las distinguen. Un ejemplo útil es una solicitud con opciones de acceso a la cuenta, fallo técnico, consulta sobre documentación y otro, con cada opción explicada. El resultado del modelo puede pasarse a la regla de enrutamiento de una aplicación. Una distribución ajustada entre fallo técnico y acceso a la cuenta es un indicio útil de ambigüedad; decide de forma explícita cómo trata el flujo de trabajo esos casos en lugar de dar por hecho que la etiqueta seleccionada es un diagnóstico confirmado.
Para la clasificación visual, proporciona una imagen legible y una condición que la imagen pueda respaldar. Una revisión de recibos podría preguntar si el importe total es legible y elegir entre categorías definidas de calidad del documento. No debería pedir un total nuevo arbitrario como si el modelo fuera un servicio de extracción o redacción sin restricciones. La interfaz de pesos abiertos del fabricante también acepta matrices de fotogramas de vídeo. Conserva la conexión entre los fotogramas y el estado escrito, y pregunta por eventos o condiciones visibles dentro de ese material.
La referencia alojada actual del fabricante indica un contexto de 24.576 tokens, hasta 64 preguntas y hasta cuatro imágenes incrustadas. Sus imágenes PNG, JPEG o WebP están limitadas a 4 MiB y 16 megapíxeles cada una, con 8 MiB descodificados en total; el cuerpo completo de la solicitud está limitado a 13 MiB y no se aceptan enlaces a imágenes remotas. Las definiciones de las preguntas y los contenidos multimedia consumen espacio de entrada, y un texto largo puede truncarse para que quepa. Coloca la evidencia decisiva en un estado compacto. Cloudflare documenta que reducir el contexto alojado no modificó los pesos publicados, por lo que la ventana alojada y la configuración de pesos abiertos siguen siendo distintas.
La salida restringida del modelo lo hace útil para comprobaciones repetidas de políticas o de flujos de trabajo. Por ejemplo, define preguntas independientes sobre si un registro cumple las normas de completitud establecidas y qué categoría de seguimiento corresponde. Mantén explícitos los criterios e incluye una opción para los casos que las categorías no cubren cuando forme parte del diseño del flujo de trabajo. Las probabilidades puntúan las opciones proporcionadas; no establecen que esas opciones constituyan una descripción completa de todas las situaciones reales.
Conserva juntos el estado, el esquema y la respuesta devuelta. Cuando un resultado sorprenda, comprueba si algún criterio es ambiguo, si faltaba una entrada decisiva o si se cortó texto relevante. Compara las valoraciones del modelo con casos revisados de la tarea real antes de fijar umbrales para acciones automatizadas. El planteamiento de Clef Flash como modelo más pequeño y de decisión rápida no sustituye a la comprobación del coste que tiene una decisión de enrutamiento incorrecta para el flujo de trabajo.
Usa el resultado tipado como entrada del siguiente paso de la aplicación. El modelo no ejecuta ese paso ni redacta su explicación posterior. Si el usuario necesita un informe, mantén la decisión y la evidencia de origen disponibles para un proceso de redacción independiente. El artefacto útil que ofrece Clef Flash es una respuesta inspeccionable para cada pregunta con nombre, con la información de probabilidad necesaria para aplicar las reglas del flujo de trabajo.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashPrimeros pasos
Cloudflare Clef Flash es el modelo de decisión Clef más pequeño, de 9B, diseñado para clasificaciones rápidas y elecciones en flujos de trabajo. Evalúa texto, estado estructurado y entradas visuales frente a preguntas con nombre, y devuelve probabilidades por opción, una categoría seleccionada o una puntuación ordenada sin generar prosa.
- Entradas aceptadas
- Texto · Imágenes
- Resultados
- decisions
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · System One POST /v1/systemone
- Tipos de entrada
text,image- Tipos de salida
decisions- Formato de salida
- json
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites cloudflare/clef-flash | Predeterminado— |
Campoprovider | Tiposchema | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoquestions | Tipoobject | RequisitoObligatorio | Valores y límites | Predeterminado— |
Camposession_id | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campostate | Tiposchema | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campotrace | Tiposchema | RequisitoOpcional | Valores y límites | Predeterminado— |
Campouser | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoquestions.<id>.type | Tipostring | RequisitoObligatorio | Valores y límites noul, choice, score | Predeterminado— |
Campoquestions.<id>.instructions | Tipostring|object|array | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campoquestions.<id>.criteria | Tipoobject|array | RequisitoOpcional | Valores y límites Condiciones: choice/score: obligatorios; noul: opcional. Los criterios de choice son un objeto; score es una lista con minItems1. | Predeterminado— |
Campoquestions.<id>.criteria.true | Tipostring|object|array | RequisitoObligatorio | Valores y límites Se aplica cuando: Se ha proporcionado un objeto de criterios noul | Predeterminado— |
Campoquestions.<id>.criteria.false | Tipostring|object|array | RequisitoObligatorio | Valores y límites Se aplica cuando: Se ha proporcionado un objeto de criterios noul | Predeterminado— |
Combinaciones de materiales de entrada
noul · Obligatorio: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obligatorio: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obligatorio: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parámetros del método y ciclo de vida
| 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 | ContratoUsa únicamente la representación exacta declarada del estado o documento. La capacidad de imagen del fabricante por sí sola no establece un formato de transmisión de imagen aceptado específico del modelo. |
Ciclo de vida: synchronous
Envía el ID exacto del modelo y conserva la respuesta nativa completa.
Planes
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas de Ailoot
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Tokens de contexto, más de | Tokens de contexto, hasta inclusive | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Tokens de contexto, más de— | Tokens de contexto, hasta inclusiveSin límite superior | Cargo Entrada · Tokens de entrada $0.000076 / 1K tokens Salida · Tokens de salida $0 / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| ConfiguraciónTramo 1 por longitud de la solicitud | Tabla de tarifas— | Tokens de contexto, más de0 | Tokens de contexto, hasta inclusiveSin límite superior | Cargo Entrada · Tokens de entrada $0.000076 / 1K tokens Salida · Tokens de salida $0 / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
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
Recibir y guardar resultados
Ailoot Ultra · System One
json
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Se conserva cada respuesta al ID de pregunta proporcionado con su tipo exacto, valor noul/choice/score, confianza, probabilidades y leyenda. El JSON original completo se almacena y solo se devuelve tras la liquidación.
Si es necesario revisar la respuesta original
Conserva la operación original y la respuesta completa o parcial; no repitas el POST.
Campos de respuesta
| 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 |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampo obligatorio, representación o valor no válido | Siguiente pasoCorrige el campo indicado de la solicitud. |
Alias
Alias del modelo
Ailoot Ultra cloudflare/clef-flash
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Cloudflare: Clef Flash
- ¿Qué entradas y resultados están disponibles?
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- ¿Qué campos utiliza la solicitud?
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user