跳转到内容
AMD AMD Radeon Cloud 文档

Clef

POST /v1/systemone model: Clef

Clef 是 Cloudflare 的 27B 决策模型，由 Qwen3.8-27B 后训练而来。适合原本要让对话模型做分类、 路由或打分、再去解析它回复的场景。

概览

Section titled “概览”
端点POST /v1/systemone
输入state（文本或任意 JSON），可选图片
输出每个问题一个答案，附概率
问题类型choice、noul、score
流式❌
计费按输入 token，对应 usage.input_tokens；output_tokens 恒为 0
情境长度超过 16,384 token 的部分会被截掉
稳定性experimental

请求

Section titled “请求”
字段
model必填Clef
state必填要判断的情境：字符串或任意 JSON 值
questions必填对象，键是你自己起的问题名，值是问题，至少一个
images可选图片数组，每项是 data: URL 字符串

temperature、prompt_format_version、return_prompt_token_ids 会被点名拒绝（422）。 问题里出现未知的键也会被拒绝，所以把 instructions 拼错成 instruction 会直接报错，而不是被悄悄忽略。

问题类型

Section titled “问题类型”
typecriteria答案
choice选项对象 {"选项名": "这个选项的含义", …}，1–255 项choice、confidence，以及每个选项的 probabilities
noul可选 {"true": "…", "false": "…"}；instructions 和 criteria 至少给一个noul：答案为”是”（或 true 成立）的概率，0–1
score有序数组，1–10 个等级，从低到高score（期望等级，从 0 数起）、confidence、legend，以及每个等级的 probabilities

每个问题都可以带 instructions，即用自然语言写的问题本身。

响应

Section titled “响应”
{
  "answers": {
    "status": {
      "type": "choice",
      "choice": "overdue",
      "confidence": 0.9895,
      "probabilities": { "paid": 0.0041, "overdue": 0.9930, "draft": 0.0029 }
    },
    "large": { "type": "noul", "noul": 0.9934 },
    "urgency": {
      "type": "score",
      "score": 1.5326,
      "confidence": 0.2989,
      "legend": { "0": "Can wait", "1": "This week", "2": "Today" },
      "probabilities": { "0": 0.0575, "1": 0.3524, "2": 0.5901 }
    }
  },
  "usage": { "input_tokens": 340, "output_tokens": 0 },
  "model": "Clef"
}

请用概率，而不只看最高的那个答案：noul 为 0.55 和 0.99 都算”是”，但只有后者适合直接自动执行。

示例

Section titled “示例”
Terminal window
curl https://developer.amd.com.cn/radeon/api/v1/systemone \
  -H "Authorization: Bearer $RADEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Clef",
    "state": {"invoice": {"vendor": "Acme", "total": 1250.0, "currency": "USD", "status": "overdue"}},
    "questions": {
      "status": {
        "type": "choice",
        "instructions": "What is the invoice status?",
        "criteria": {"paid": "Invoice is paid.", "overdue": "Invoice is past due.", "draft": "Not sent."}
      },
      "large": {"type": "noul", "instructions": "Is the total above 1000 USD?"},
      "urgency": {"type": "score", "instructions": "How urgent is follow-up?", "criteria": ["Can wait", "This week", "Today"]}
    }
  }'

带图片：

{
  "model": "Clef",
  "state": "Look at the attached picture.",
  "images": ["data:image/png;base64,iVBORw0KGgo..."],
  "questions": {
    "colour": {
      "type": "choice",
      "instructions": "What colour fills the image?",
      "criteria": {"red": "Red", "green": "Green", "blue": "Blue"}
    }
  }
}