获取模型列表

在编写生成请求前，先查询当前 API Key 能看到的模型列表。模型可用性可能随 Key 分组和渠道变化，因此不要只根据教程猜测模型名称。

模型占位符

其他页面统一使用 YOUR_MODEL_ID。请从本接口返回的 data[].id 中复制一个当前 Key 可用的模型 ID，并用它替换该占位符。

示意图：模型 ID 从 data[].id 原样读取；可复制的地址、命令和代码仍以正文为准。

请求

• 方法： GET
• Endpoint 路径： /models
• 完整请求地址： https://duckmans.com/v1/models

old_stty=$(stty -g)
trap 'stty "$old_stty"' EXIT INT TERM
printf "DuckMans API Key: "
stty -echo
IFS= read -r DUCKMANS_API_KEY
stty "$old_stty"
trap - EXIT INT TERM
printf '\n'
export DUCKMANS_API_KEY

curl -sS https://duckmans.com/v1/models \
  -H "Authorization: Bearer $DUCKMANS_API_KEY"

读取返回结果

OpenAI 兼容返回通常包含 data 数组，每个条目的 id 是请求时使用的模型 ID。以下结构仅用于说明字段，实际列表以你的请求结果为准：

{
  "object": "list",
  "data": [
    {
      "id": "YOUR_MODEL_ID",
      "object": "model"
    }
  ]
}

将实际响应中的 ID 原样复制到请求的 model 字段。不要自行修改大小写、添加显示名称或根据别的分组推断 ID。

示意图：模型可见性、协议支持和调用权限需要分别确认；可复制的地址、命令和代码仍以正文为准。

为什么看不到某个模型

常见原因包括：

1. 当前 Key 选择的分组不包含该模型。
2. 模型或渠道当前没有对该分组开放。
3. 客户端缓存了旧列表，尚未重新拉取。
4. 使用了另一个 Key，或环境变量仍保存旧 Key。

可先重新调用 /models，再对照后台确认 Key 和分组。模型出现在列表中，也不等于该分组支持所有接口协议；Responses 与 Chat Completions 仍需分别按实际支持情况测试。

在脚本中只打印 ID

如果本机安装了 jq：

curl -sS https://duckmans.com/v1/models \
  -H "Authorization: Bearer $DUCKMANS_API_KEY" \
  | jq -r '.data[].id'

不要把完整响应连同请求头上传到公开工单。排错时只需提供 HTTP 状态码、打码后的 Key、所选分组和模型 ID。