支持的模型

FreeDom API 提供多种可用模型。实际可用范围以控制台、模型广场和当前 API Key 权限为准。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

Claude 系列

常见模型示例：

模型	适合场景
claude-sonnet-4-5-20250929	日常编程、写作、Agent 任务
claude-sonnet-4-5-20250929-thinking	复杂推理、长链路任务
claude-opus-4-8	高质量代码、复杂分析
claude-opus-4-8-thinking	高难推理、复杂项目规划
claude-haiku-4-5	轻量任务、低成本快速响应

Gemini 系列

模型	适合场景
gemini-2.5-pro	综合推理、长文本、代码
gemini-2.5-flash	快速问答、低成本任务
gemini-3-pro-preview	新能力测试、复杂任务
gemini-3-pro-image	图像理解/图像相关任务

图像模型

如果平台开放图像模型，可在支持图片生成的客户端中使用。模型名以控制台为准，例如 gpt-image-2、gemini-*-image 等。

选择建议

• 日常开发：Sonnet / Flash 级别模型
• 复杂代码：Opus / Pro 级别模型
• 低成本心跳或批处理：Haiku / Flash Lite
• 图像任务：选择明确支持 image 的模型

注意事项

WARNING

同一个模型在不同 Key 或不同套餐下，价格、速度、可用性可能不同。正式大量使用前，请先做小流量测试。

模型名实证原则

模型名不要只看外部教程。最终以 FreeDom API 控制台、模型广场、实际 /v1/models 返回和当前 API Key 权限为准。

用户排查模型问题时应确认：

1. 模型名完全一致，包括 -、.、:thinking、-thinking。
2. 当前 API Key 是否有该模型权限。
3. 当前模型是否配置价格、缓存倍率、输出倍率。
4. 客户端是否会自动改写模型名。

如果 401，先看 Key；如果 404 Model Not Found，优先看模型名与 Key 权限。