AsterMesh Wiki
AsterMesh AI API 中转站使用文档，帮助你接入对话模型，并通过 Sora 兼容接口生成视频。
欢迎来到 AsterMesh Wiki。AsterMesh 是 AI API 中转站，模型来源覆盖 Claude、Gemini、OpenAI、DeepSeek，主站是 https://astermesh.cn。接入大多数工具只需要改 Base URL 和 API Key 两个配置。
从你的客户端开始
大部分用户用的是下面四个 coding agent，点进去按步骤配置即可：
Claude Code设置两个环境变量，走 Anthropic 兼容协议接入。Codex在 config.toml 里注册 AsterMesh model provider。Pi在 models.json 中注册 AsterMesh provider。OpenClaw配置 OpenAI 兼容 provider，一步接入。
用的是 Cursor、Raycast、Cherry Studio 等其他工具？查看 全部客户端示例；写代码接入见 SDK 与框架。
需要生成视频？查看 视频生成，按 h3 示例完成参考图片上传、创建任务、查询进度和下载视频。
最常用的信息
| 项目 | 值 |
|---|---|
| 主站 | https://astermesh.cn |
| 控制台（注册、登录与 API Key 管理） | https://console.astermesh.cn |
| OpenAI 兼容 Base URL | https://console.astermesh.cn/v1 |
| Anthropic 兼容接口 | Base URL 只填 https://console.astermesh.cn，客户端自动拼接 /v1/messages |
| Sora 兼容视频接口 | 使用 https://console.astermesh.cn/v1，详见 视频生成 |
| 鉴权方式 | Authorization: Bearer <你的 API Key> |
官网用于产品介绍；注册和登录使用控制台链接，API 请求使用上表中的接口地址。配置客户端时，请保留对应的路径。
给新手的提醒
API Key 相当于密码。不要发到群里，不要截图公开，不要提交到 GitHub。配置客户端时，通常只需要改 Base URL 和 API Key。
从这里开始
快速开始
从注册账号到第一次请求，按步骤完成最小闭环。
API Key 与账号
创建、保存、轮换和排查 API Key。
模型与路由
模型 ID 从哪里复制，路由怎么选。
视频生成
使用 h3 完成素材上传、创建任务、查询状态和下载视频。
常见问题
401、404、429、模型不存在、余额不足等问题的处理方式。