GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
全部教程与指南

· reAPI Team

Together AI model not available:目录与 API 访问

通过检查准确的模型 ID、serverless 支持、专用端点就绪状态、项目范围和 API 响应,解决 Together AI model not available 错误。

Together AI model not available:目录与 API 访问

在 Evo 项目的一则历史问题中,Together 响应报告了 model_not_available,并解释说,该请求正在尝试使用非 serverless 模型。建议的下一步是使用专用端点。[1] 模型确实存在。该响应指出的问题在于尝试调用它的方式。

这份报告不能证明当前发生了服务中断,也不能证明某个模型今天是否可用。它说明了完整消息为何重要。Together 文档为 serverless 推理和专用推理列出了不同的模型集合,而专用模型仍然需要可用的部署。[2][3] 从应用实际发送的请求入手,而不是从你以为它会使用的模型卡片入手。

复制模型值、主机和路径

从失败的请求中获取准确的 model 字符串。保留其命名空间、版本和变体后缀。在旁边记录解析后实际使用的 API 主机和请求路径,以及 HTTP 状态和完整错误正文。分享这些材料前,移除身份验证密钥。

然后确定模型值的来源。当前的 serverless 列表、旧 SDK 示例和专用端点界面可能提供不同类型的标识符。熟悉的显示名称并不意味着它们可以互换。

对于 Together 当前的专用工作流,推理请求使用形式为 project_slug/endpoint_name 的端点字符串。目录模型 ID 标识选来部署的模型;端点字符串标识为请求提供服务的资源。[3] 因此,一则配置说明可能包含以下两个不同的值:

Model selected for deployment: <catalog-model-id>
Model value used for inference: <project-slug>/<endpoint-name>

这些是用于展示区别的占位符,不是可供调用的端点。根据实际打算使用的模型和部署填写它们。把第一个值复制到要求第二个值的字段中,并不会因为两者指向同一模型系列就变得正确。

还要检查任务。Together 的目录涵盖聊天、图像、视觉、视频、音频和其他操作,并为每种操作提供端点指导。[2] 图像模型出现在列表中,并不能证明它可以处理聊天补全请求。在更换凭证或认定购买额度就能解锁它之前,先检查操作类型。

使用 serverless 时,查阅 serverless 列表

如果应用调用的是共享 serverless 推理,将完整 ID 与 Together 当前的 serverless 模型列表进行比较。范围更广的目录和专用模型列表回答的是不同的问题。[2] 这也回答了“哪些模型可用”:查询时必须明确是用于什么任务、采用哪种服务模式。

在调试记录中保留 ID 的来源。如果它来自为其他路由编写的教程,在凭猜测修改模型名称之前,先查阅该路由的文档。如果它来自旧示例,验证该准确变体是否仍在提供服务。相近的名称可能标识另一个模型,而成功调用替代模型并不能解释原来的失败。

如果文档中的路由已退役,问题就从配置诊断变成了迁移。使用 Together AI 弃用指南评估接替方案和截止日期。反复使用已退役的 ID 或轮换其密钥,都不能恢复已移除的路由。

如果准确 ID 位于正确的当前列表中,保留这一证据,继续检查调用方的账户和客户端配置。现在的问题比“提供商究竟有没有这个模型”更具体了。

使用专用推理时,检查你自己的部署

Together 的专用工作流会创建端点、关联部署并建立路由。部署就绪后才能进行推理。[3] 支持部署某个模型,并不意味着你的项目已经有了该模型的就绪副本。

在目标项目中找到目标端点。检查其部署状态以及为它显示的准确推理字符串。检查应用是否正在调用该端点,而不是继续把原来的目录 ID 发送到 serverless 或网关路由。

先前正常工作的配置出问题后,项目重命名是尤其值得检查的具体事项。Together 文档说明,更改项目 slug 会立即改变以 slug 限定的资源引用,旧 slug 不会重定向。[4] 在这种情况下,模型和部署可能仍然存在,而保存的端点字符串却指向过时的名称。

创建另一个部署前,检查本应已经在承载工作负载的部署。专用推理按分钟对运行中的硬件计费,因此,额外配置一个端点是涉及成本的容量决策。[3] 如果端点名称不匹配就能解释失败,这种诊断捷径并不合适。

定价也取决于路由。Together 的 serverless 聊天列表采用 token 费率,其他模态采用文档注明的单位,专用推理则采用其硬件计费安排。[2][3] 在比较 token 报价与部署成本之前,先确定请求试图访问哪种服务。

浏览器中的项目可能不是工作进程的项目

Together 将资源和 API 密钥限定在项目范围内。有权访问一个项目的资源,并不能自动证明有权访问另一个项目的端点。[4] 因此,控制台中可见的项目只是部分证据。

设想一个假设情景:工作进程仍配置着 Project A 的密钥,而你在浏览器中检查 Project B 下的就绪端点。控制台视图可能是正确的,工作进程却仍然可能使用错误的访问上下文。检查可安全查看的凭证标识符和进程的实际配置,不要把密钥粘贴到日志中。

如果客户端或部署工具提供多种项目选择方式,沿配置优先级排查。显式设置、环境值和已认证的管理上下文需要与目标资源一致。[3][4] 将失败的工作进程纳入检查;笔记本电脑上的成功调用并不能证明另一个进程加载了什么。

如果使用的是 reAPI 或其他主机,则使用该目标服务的模型标识符和凭证格式。reAPI 身份验证参考描述的是其自身的凭证;它不能激活 Together 项目,也不能让 Together 密钥跨服务通用。[5] 比较配置时,将主机和凭证的变更放在一起核对。

检查 SDK 是否直接调用 Together

AI SDK 的 Together 集成文档介绍了两条路径:AI Gateway 和直接使用 @ai-sdk/togetherai 提供商。按照文档描述的 SDK 行为,单独的模型字符串默认使用 Gateway;直接提供商则会创建为 Together 配置的模型实例。[6]

以下仅涉及配置的示例比较了 Gateway 与直接提供商。占位 ID 必须替换成各自目录支持的 ID;它不会发送推理请求。这不是完整的专用端点设置:该工作流还需要文档规定的推理主机或基础 URL,以及项目/端点字符串。

import { togetherai } from '@ai-sdk/togetherai';

const gatewayOptions = {
  model: 'MODEL_ID_IN_GATEWAY_CATALOG',
};

const directOptions = {
  model: togetherai('MODEL_ID_IN_TOGETHER_CATALOG'),
};

文档中的 Gateway 配置使用 AI_GATEWAY_API_KEY;直接提供商默认使用 TOGETHER_API_KEY。两者可用的模型和功能可能不同。[6] 在环境的某个部分提供了 Together 凭证,并不能证明单独传入字符串的请求使用了该凭证。

Gateway 的提供商顺序选项也是值得准确阅读的细节。文档中的顺序表示偏好并允许回退;它不会把所有请求都限制到指定提供商。[6] 因此,成功的 Gateway 请求本身并不能证明你的直接 Together 项目可以为该模型提供服务。

对照文档检查已安装的 SDK 版本和解析后的连接设置。客户端可能应用了基础 URL 或其他默认值,而这些值在你自己的代码中并没有显示在模型名称旁边。在替换软件包或修改无关的应用逻辑之前,先比较构造出来的请求。

将诊断请求简化到文档规定的操作和必需字段,同时保持目标主机、账户和模型不变。然后将其与应用请求比较。如果最简形式成功而完整形式失败,逐个恢复可选功能,让差异保持可见。如果两者都返回相同的可用性消息,更改提示词不太可能解释路由不匹配。你选择为这项比较运行的任何推理都可能产生费用;将其控制在正常获批的测试预算内,不要把尚未解决的请求放进自动重试循环。

对于图像、嵌入或重排序任务,还要检查是否使用了 SDK 文档中相应的提供商工厂和操作。[6] 即使模型字符串的拼写与目录一致,通过错误操作传入它仍然是错误的请求。

让剩余的错误决定下一项变更

路由和调用方一致后,阅读实际错误,不要继续将每次拒绝都解释为缺乏模型支持。Together 的参考文档区分了身份验证失败、支出截止限制、受限访问、无效 URL 或模型名称、限流以及临时服务不可用。[7]

401 指向身份验证问题。402 可能表示支出截止限制或正额度要求。403 需要查看所指明的访问原因。429 需要结合操作上下文:serverless 限流与专用管理请求超出 GPU 配额是不同的情况。Evo 的历史响应也说明,为何不应硬编码认定 model_not_available 总是随 404 返回。[7][1]

不要把目录中的条目当成免费托管访问的证明。于 2026 年 11 月 16 日查阅的 Together 额度政策说明,没有免费试用,要求首次至少购买 US$15,并说明免费额度不能满足这一最低要求。继续使用预付费访问需要正余额;有效的 Scale 和 Enterprise 合同有各自的条款。[8] 这些条件与错误的模型 ID 或路由是不同的问题。再次付款无法纠正其中任何一个字符串。

如果配置和文档中的可用性仍与响应矛盾,将这一准确矛盾发送给支持团队:准确的 ID 或端点、主机和路径、目标项目、时间戳、SDK 版本、HTTP 状态,以及移除敏感信息后的完整错误。如果返回了请求 ID,也一并提供。说明检查过哪个当前列表或就绪部署。这样,支持团队就能调查失败的请求,而不必从模型卡片截图中推断请求内容。

参考资料

  1. Evo 项目,GitHub 问题 95,api.together.ai 上模型不可用,包括回复。历史报告查阅于 2026 年 11 月 15 日。
  2. Together AI,可用模型:serverless 目录、任务类型及专用模型的区别。查阅于 2026 年 11 月 15 日。
  3. Together AI,专用模型推理概述:项目选择、就绪状态、端点字符串和硬件计费。查阅于 2026 年 11 月 15 日。
  4. Together AI,项目:资源边界、项目 API 密钥和 slug 更改。查阅于 2026 年 11 月 15 日。
  5. reAPI,身份验证。查阅于 2026 年 11 月 15 日。外部来源 URL 和完整快照保留在研究归档中。
  6. AI SDK,Together.ai 提供商:Gateway 和直接提供商配置。查阅于 2026 年 11 月 15 日。
  7. Together AI,错误代码。查阅于 2026 年 11 月 15 日。
  8. Together AI,额度:免费试用政策、首次购买要求和合同例外。查阅于 2026 年 11 月 16 日。
全部教程与指南