模型文档分为两层：
- 文档站展示平台通用模型能力和调用方式。
- 控制台展示当前账号实际可见模型、真实价格和权限。
推荐字段
后续模型目录建议由 sanitized manifest 生成，字段包括：
| 字段 | 说明 |
|---|
id | 调用时填写到 model 的模型 ID |
display_name | 展示名称 |
modality | 文本、图片、视频等能力 |
supported_endpoints | 支持的公开 endpoint |
billing_units | token、image、video 等计费单位 |
supports_stream | 是否支持流式输出 |
status | available、beta、deprecated 等状态 |
不要为每个普通模型手写重复教程。只有特殊参数、特殊计费或特殊生命周期的模型才需要独立详情页。
当前建议模型分层
| 模型类型 | 推荐模型 ID 示例 | 推荐接口 | 计费口径 | 说明 |
|---|
| 文本对话模型 | gpt-4o-mini、claude-sonnet-4 | /v1/chat/completions | token | 适合聊天、工具调用、JSON 输出和流式输出 |
| Responses 模型 | gpt-4o-mini | /v1/responses | token | 适合 OpenAI Responses 语义和多模态输入 |
| Claude 原生模型 | claude-sonnet-4 | /v1/messages | token / cache token | 保留 Anthropic Messages 请求结构和 usage 语义 |
| 同步图片模型 | gpt-image-2 | /v1/images/generations | 以模型配置为准 | OpenAI 兼容图片生成入口 |
| 图片异步模型 | gpt-image-2-async | /v2/images/generations | image | 任务制接口，创建后轮询查询结果图 |
| 视频模型 | seedance-2.0 | /v1/videos/generations | token / task | 任务制接口，适合长耗时视频生成 |
模型名可能带质量档后缀，例如 -economy、-standard、-premium。后端会根据模型、档位、域名、API Key 白名单和 endpoint capability 决定是否可调用。
