APIMart 模型名称怎么填？模型 ID、展示名与接口类型核对指南
简答：APIMart 的“模型名称”字段通常优先填写 API 模型 ID，例如文档示例中的 <code>gpt-4o</code>、<code>gemini-2.0-flash-exp</code> 或 <code>claude-sonnet-4-5-20250929</code>，不要直接填 GPT、Gemini、Claude 这类展示名称。实际可用 ID 会随模型目录、账户权限和接口类型变化，发送请求前应以当前模型详情页或接口文档为准。
定义：模型展示名称是给人看的名称，API 模型 ID 是请求体中用于定位具体模型的字符串，两者不能默认互换。
先看结论：模型名称字段应该填什么
本文是面向接入排查的独立指南，不代表 APIMart 官方页面。最短判断规则是：如果字段位于 API 请求体、SDK 配置、命令行参数或客户端的 Model/模型 ID 输入框，优先填写当前文档提供的 API 模型 ID；如果字段明确写着“展示名称”“显示名称”或“模型标签”，才填写给人看的名称。
| 字段或位置 | 通常应填写 | 不要直接填写 | 核验方法 |
|---|---|---|---|
OpenAI 兼容请求的 model | API 模型 ID | 中文名称、品牌类别、模型详情页标题 | 查看当前模型文档中的请求示例 |
Gemini CLI 的 --model | 命令示例中的模型 ID | Gemini、GPT、Claude 等简称 | 对照客户端和网关文档 |
| 模型市场搜索框 | 展示名称或关键词 | 把搜索结果标题当成 API ID | 进入具体模型详情页 |
| 图像或视频任务接口 | 该任务接口支持的模型 ID | 聊天模型 ID、展示名称 | 查看对应图像或视频接口文档 |
当前公开页面将“模型展示名称（示例，非 API 模型 ID）”单独标注，并提醒实际数量与模型 ID 以当前 Key 的返回结果为准；因此不能把模型市场上的标题机械复制到 API 请求中。相关页面
APIMart 模型 ID 怎么查：按这 4 步核对
- 先确定接口类型。先判断你要调用的是聊天、图像、视频、音频，还是某个客户端的专用适配器。接口类型不同，支持的模型字段和参数可能不同。
- 在模型市场搜索模型。模型市场可以按图像、视频、LLM、音频等类别筛选，也能搜索模型名称。但搜索结果主要用于定位模型，不代表页面标题就是可直接发送的 ID。打开模型市场页面
- 进入模型详情或接口文档。查找代码示例、请求体中的
model字段、Supported models 或“模型 ID”表格。文档示例中，Gemini CLI 使用--model gpt-4o，也展示了claude-sonnet-4-5-20250929这类完整字符串。查看 Gemini CLI 接入文档 - 复制后再核对字符。重点检查大小写、连字符、点号、版本后缀和日期后缀。不要手动把展示名改写成猜测的 ID，也不要把前后空格、反引号或中文标点一起复制。
如果当前模型市场只有展示名称、没有明确的 API 模型 ID，本文不建议根据名称推断。应继续查找该模型的接口文档，或使用账户和当前接入方式能够返回的模型信息；无法核实的名称应标记为“未核实”，不要直接用于生产配置。
最小请求怎么写：先用已核实的模型示例测试
对于 OpenAI 兼容聊天接口，最小测试只保留认证、模型和一条消息。下面的模型值来自当前可检索到的接入文档示例，属于示例值，发送前仍需核对当前账户、模型权限和文档版本；API Key 不要写进代码、截图或公开仓库。
curl https://api.apimart.ai/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_API_KEY" -d '{"model":"gpt-4o","messages":[{"role":"user","content":"只回复：测试成功"}]}'
文档同时给出了 gemini-2.0-flash-exp 的聊天请求示例，并在 Gemini CLI 中展示了 gpt-4o 与 claude-sonnet-4-5-20250929 的指定方式。具体模型是否仍可用、是否对当前 Key 授权，不能仅凭示例判断，应以当前模型文档和实际响应为准。查看请求示例与模型 ID 示例
一次成功调用至少检查四项：HTTP 状态码是否成功、响应体是否存在预期字段、实际文本是否由目标模型返回、客户端界面是否正确显示结果。只有看见响应体和客户端结果，才算完成模型名称核验。
聊天、图像、视频模型不能混填
模型 ID 不只由模型名称决定，还受接口类型约束。聊天接口通常使用消息列表和 model 字段；图像或视频接口可能使用专用路径、任务参数和异步任务状态。即使某个名称在模型市场中存在，也不代表它可以放进聊天接口。
| 使用场景 | 填写重点 | 常见误区 |
|---|---|---|
| 聊天或代码生成 | 使用聊天接口文档中列出的模型 ID | 把市场展示名或图像模型填入 chat/completions |
| 图像生成 | 使用图像接口对应的模型 ID和参数 | 只复制模型标题，不核对输入类型和接口路径 |
| 视频生成 | 使用视频生成文档中声明的模型值 | 把聊天模型 ID或视频展示名混入视频任务请求 |
| 第三方客户端 | 确认该字段要求“模型 ID”还是“模型名称” | 同时修改 Base URL、Key 和模型，导致无法判断真正原因 |
例如，视频接口文档中的请求示例使用 kling-v3 或 doubao-seedance-2.0 作为视频任务的 model 值，并通过视频生成路径提交任务。这只能说明这些文档示例中的写法，不能推导出所有模型都使用相同路径或字段。查看视频模型接口示例
如果客户端只有一个笼统的“模型名称”输入框，先确认它最终发送到哪个接口；无法确认时，优先使用客户端的 API 调试日志或请求预览，检查实际 JSON 中的 model 值和请求路径。
模型不存在、无权限或版本失效：按顺序排查
- 检查凭据。确认使用的是当前账户创建的 API Key，且没有复制空格、换行或已撤销的旧 Key。
- 检查最终 URL 和路径。确认 Base URL 拼接后没有重复的
/v1、缺少版本路径，且聊天、图像、视频没有混用接口。 - 检查模型值。从请求日志中复制实际发送的
model字符串，与当前模型详情页逐字符比较。 - 检查权限和区域。某个模型出现在公开目录中，不等于当前 Key、账户或接入方式一定拥有调用权限；以响应体中的错误信息和当前文档为准。
- 回到最小请求。删除流式、图片、工具调用和复杂参数，只保留一个短文本请求，避免把参数错误误判成模型名称错误。
- 查看错误响应体。
401、403、404、429的具体含义不能只靠状态码猜测，应结合响应体、响应头和日志判断。若响应明确指向 model not found、未授权或限流，再分别处理模型值、权限或请求频率。
如果模型曾经可用、现在返回不存在，先不要自行添加版本号或替换成相近名称。重新打开当前模型详情页，确认是否更换了 ID、接口类型或可用状态；没有公开证据时，只能写“当前状态未核实”。
第三方客户端填写时的自查清单
- 模型字段：确认字段说明要求的是 Model ID、Model name 还是 Alias。
- Base URL：只填写客户端要求的基础地址，不要把完整的
/chat/completions路径重复粘贴到 Base URL。 - API Key：使用环境变量或客户端的安全凭据存储，不在诊断命令中回显完整 Key。
- 请求协议：确认客户端是否使用 OpenAI 兼容格式，以及它是否支持当前模型的聊天、图像或视频能力。
- 模型权限：先用一个当前文档明确给出的模型示例做最小请求，再切换目标模型。
- 版本变化：模型目录和 ID 会更新，本文中的示例不是永久清单，发送请求前应重新核验。
如果你使用的是 Agent、MCP 或本地技能，公开页面还特别提醒：模型展示名称不等于 API 模型 ID，实际数量与 ID应以当前 Key 的返回结果为准。查看模型发现与接入提示
常见问题
APIMart 模型名称到底填展示名还是模型 ID？
在 API 请求、SDK、命令行或客户端的 Model/模型 ID 字段中，通常应填写 API 模型 ID，而不是 GPT、Claude、Gemini 这类展示名称。若字段明确写的是展示名称或标签，才按界面要求填写。
可以把模型市场上的名称直接复制到 model 字段吗？
不建议直接复制。模型市场页面可能展示给人阅读的名称，公开页面也明确提示展示名称不等于 API 模型 ID。应进入模型详情或接口文档，复制请求示例中的模型值。
为什么模型名称正确，仍然提示模型不存在？
可能是请求路径与模型类型不匹配、当前 Key 没有权限、模型版本已变化，或实际发送的字符串包含空格、大小写或连字符错误。应查看错误响应体和最终请求日志，不要只根据状态码猜原因。
GPT、Claude、Gemini 的模型 ID可以互换吗？
不能。不同模型系列的 ID、接口支持范围和参数可能不同。当前文档示例分别展示了 <code>gpt-4o</code>、<code>gemini-2.0-flash-exp</code> 和 <code>claude-sonnet-4-5-20250929</code>，但这些示例是否仍对你的账户可用，需要重新核验。
图像或视频模型也填到聊天接口的 model 字段吗？
不能默认这样做。图像和视频通常有各自的接口路径、输入字段和任务流程。应先确认目标客户端调用的是聊天、图像还是视频接口，再使用对应文档列出的模型 ID。
模型 ID 查不到时，能否根据展示名称自己推断？
不建议推断。若当前资料没有明确给出 API 模型 ID，应标记为未核实，并继续查找当前模型详情、接口文档或账户可用模型信息。自行添加版本号、日期后缀或连字符可能导致调用失败。
相关阅读
参考资料
- 在 Gemini CLI 中使用 APIMart：模型参数与 OpenAI 兼容请求示例（docs.apimart.ai）
- AI 模型市场：模型分类、搜索与展示名称
- Agent Tools：展示名称与 API 模型 ID 的区别说明
- Kling v3 Video Generation：视频模型请求示例（docs.apimart.ai）