模型与分组¶
Claude Code、Codex 可以使用其他分组的 API Key,但必须配置该分组支持的模型 ID。 选择分组时,先看你要用的模型。
本页只汇总文档中已写明的信息;控制台若展示更多可选模型,以控制台与当前分组实际列表为准。
怎么用这张表¶
- 先确定你要做的事(写代码 / 生图 / 生视频)。
- 在控制台选择支持目标模型的分组,创建 API Key(见 获取 API Key)。
- 按所用客户端的教程填写 Base URL 与密钥。
- 把客户端的模型 ID 设置为该密钥所属分组支持的值。
切换分组时,要同时核对模型 ID。如果原来的默认模型不在新分组的支持列表中,需要一起修改。
场景 × 分组 × 客户端¶
| 你想做什么 | 分组选择 | 推荐客户端 / 入口 | Base URL | 配置方式 |
|---|---|---|---|---|
| 用 Claude Code 写代码 | 支持目标模型的分组 | Claude Code、VS Code · Claude | https://jarlessapi.com |
填写环境变量,并指定模型 ID |
| 用 Codex 写代码 | 支持目标模型的分组 | Codex、VS Code · Codex | https://jarlessapi.com/v1 |
填写 config.toml、auth.json,并设置 model |
| Gemini CLI 编程 | Gemini CLI 对应分组 | Gemini CLI | https://jarlessapi.com |
环境变量 GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY |
| Grok 对话 / 写代码 | Grok 分组 | Grok Build | https://jarlessapi.com/v1 |
~/.grok/config.toml(必须带 /v1) |
| GPT / Gemini 生图 | 生图对应分组(OpenAI Images Key / Gemini 图片 Key 按模型区分) | 网页端、API、Skill | https://jarlessapi.com(若控制台/客服另有说明,以其为准) |
Authorization: Bearer <api_key> |
| Seedance 生视频 | 已开通视频生成能力的分组 | Seedance 生视频 | https://api.jarlessapi.com |
Authorization: Bearer <api_key> |
| Grok 生图 / 生视频 | Grok 分组(需开启生图权限) | Grok 生图、Grok 生视频 | https://jarlessapi.com |
Authorization: Bearer <api_key> |
编程客户端的模型配置¶
下面是接入教程中的模型设置。使用其他分组时,按该分组的可用模型列表填写。
| 客户端 | 文档默认模型 | 备注 |
|---|---|---|
| Claude Code | 客户端默认模型,或手动指定模型 ID | 在对话中输入 /model 切换,也可直接输入 /model 模型ID |
| Codex | gpt-6-astra |
在对话中输入 /model,选择该分组支持的模型;列表中没有目标模型时,再修改 config.toml 的 model |
| Gemini CLI | 由客户端默认或启动参数决定 | 本站接入示例使用 Gemini CLI 分组 |
| Grok Build | grok-4.6 |
见 ~/.grok/config.toml 的 [models].default |
生图模型¶
| 模型 ID | 协议 / 路径倾向 | 典型用途 | 常用参数 |
|---|---|---|---|
gpt-image-2 |
OpenAI Images:/v1/images/generations、/v1/images/edits |
高质量文生图、图生图、参考图编辑 | size、quality、stream |
gpt-image-2.5-flare |
OpenAI Images,同 gpt-image-2 |
文生图、图生图、参考图编辑 | size、quality、stream |
gpt-image-2.5-sunburst |
OpenAI Images,同 gpt-image-2 |
文生图、图生图、参考图编辑 | size、quality、stream |
gemini-3-pro-image |
Gemini v1beta | 更高质量 Gemini 出图 | imageConfig.aspectRatio、imageConfig.imageSize |
gemini-3.1-flash-image |
Gemini v1beta | 较新的 Gemini 图片场景 | imageConfig.aspectRatio、imageConfig.imageSize |
grok-imagine |
Grok Imagine(映射高质量上游) | Grok 文生图(推荐) | prompt;改图另走 edits |
grok-imagine-image-quality |
同名上游 | 高质量 Grok 生图 | 同生图接口 |
grok-imagine-image |
同名上游 | 更快的 Grok 生图 | 同生图接口 |
不要用 preview 别名当前端模型名
生图文档明确:不要使用 gemini-*-flash-image-preview 作为前端图片模型名。请使用上表中的正式 ID。
生图参数速查¶
gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 沿用 gpt-image-2 的接口与参数。
| 目标 | gpt-image-2 |
Gemini 图片 | Grok Imagine |
|---|---|---|---|
| 普通方图 | size=1024x1024 |
1:1 |
aspect_ratio=1:1 |
| 横版封面 | 1536x1024 |
16:9 |
aspect_ratio=16:9 |
| 竖版海报 | 1024x1536 |
9:16 |
aspect_ratio=9:16 |
| 高清 | quality=high |
imageSize=4K |
优先 grok-imagine / grok-imagine-image-quality |
| 草稿 / 省成本 | quality=low |
imageSize=1K |
grok-imagine-image |
生视频模型¶
| 模型 ID | 用途 | 注意 |
|---|---|---|
seedance-2.0 |
Seedance 2.0 | 使用 /v1/videos/tasks |
seedance-2.0-fast |
Seedance 2.0 Fast | 使用 /v1/videos/tasks |
seedance-2.0-mini |
Seedance 2.0 Mini | 见 文生视频示例 |
seedance-2.5 |
Seedance 2.5 | 见 图生视频与多素材参考 |
grok-imagine-video |
文生视频(推荐) | 异步创建,需轮询 request_id |
grok-imagine-video-1.5 |
图生视频 | 必须带图;不带图会把错误交给上游 |
grok-imagine-video-1.5-preview |
1.5 preview | 预览能力,以实际开通为准 |
Seedance 的 API 地址是 https://api.jarlessapi.com,创建任务使用 /v1/videos/tasks,查询与下载使用返回的 task_id,具体见 Seedance 接入指南。
Grok 使用 https://jarlessapi.com/v1/videos/generations 创建任务,查询与下载沿用创建时的 API Key。Grok 的 resolution 可选 480p、720p、1080p,其中 1080p 以 1.5 系列为准。
Base URL 对照(最容易写错)¶
| 入口 | Base URL | 常见错误 |
|---|---|---|
| Claude Code / Gemini CLI / 多数 HTTP API | https://jarlessapi.com |
多写或少写路径、写成别的中转域名 |
| Codex CLI / VS Code · Codex | https://jarlessapi.com/v1 |
漏掉 /v1 |
| Grok Build(TUI/CLI 聊天) | https://jarlessapi.com/v1 |
漏掉 /v1 |
| Grok 生图 / 生视频 HTTP | https://jarlessapi.com |
与 Grok Build 聊天配置混用路径习惯 |
| Seedance 生视频 HTTP | https://api.jarlessapi.com |
遗漏域名中的 api.,或使用旧的任务路径 |
| 图片 OpenAI / Gemini API | 文档与 Skill 使用 https://jarlessapi.com;若你的部署另有说明,以控制台/客服为准 |
把示例占位符原样写进生产配置 |
密钥与能力检查清单¶
在怀疑「模型坏了」之前,按顺序勾选:
- 分组:在控制台确认当前 API Key 属于哪个分组,以及该分组支持哪些模型。
- Key 是否生效:新开终端后检查密钥是否已配置,或核对
auth.json/config.toml;不要把完整密钥打印到排错输出中。 - Base URL:是否与上表完全一致(尤其 Codex 和 Grok Build 的
/v1)。 - 模型 ID:是否在当前密钥所属分组的可用列表中;切换分组后是否同步更新了模型配置。
- 权限:Grok 生图/生视频是否已在分组上开启生图权限。