AnyStarX Wiki
AnyStarX API 接入文档,涵盖主流对话模型接入、Sora 兼容视频生成接口与客户端配置。
AnyStarX 是一站式 AI API 接口服务。通过一个账号、一组 API Key 和统一的 Base URL,可以直接调用 Claude、Gemini、OpenAI、DeepSeek 等主流模型,并支持 Sora 兼容格式的视频生成接口。官方网站地址为 https://anystarx.com。
本页介绍 AnyStarX 的基础地址、接口类型与鉴权方式。如果需要配置具体的客户端工具,可以参考 客户端配置。
基础信息
| 配置项 | 地址与说明 |
|---|---|
| 官方网站(产品介绍与动态) | https://anystarx.com |
| 管理控制台(注册登录、创建密钥、查看模型与用量) | https://console.anystarx.com |
| OpenAI 兼容 Base URL | https://console.anystarx.com/v1 |
| Anthropic 兼容 Base URL | 填入 https://console.anystarx.com,由客户端自动追加 /v1/messages |
| Sora 兼容视频接口 | 使用 https://console.anystarx.com/v1,调用流程参考 视频生成 |
| 接口鉴权方式 | 请求头添加 Authorization: Bearer <你的 API Key> |
账号注册与额度管理在控制台完成,实际发起请求时使用上表列出的接口地址。配置 OpenAI 兼容客户端时,Base URL 只填写到 /v1,不要在基础地址后追加具体的接口路径。
模型与计费
各模型的可用状态、上下文长度和计费单价会随上游服务调整,具体信息以控制台展示为准:
- 模型 ID 需要直接从控制台模型列表复制,避免手动输入产生拼写错误;也可以通过
GET https://console.anystarx.com/v1/models接口获取当前可用的完整列表。 - 模型 ID 格式可能包含提供商前缀(例如
anthropic/claude-sonnet-4-5),也可能直接使用原始名称(例如claude-sonnet-4-5),调用时应与控制台列表保持一致。 - 模型选择建议、上下文限制以及
model_not_found错误的排查步骤,参考 模型与路由。
单次调用的费用根据输入 token 数量与模型回复产生的输出 token 数量计算。使用 coding agent 时,agent 在后台自动规划、读取代码、执行工具等中间操作都会各自发起 API 请求,这些请求会累计计入总消耗。账户余额、充值套餐和账单明细可以在控制台查看;用量排查与额度控制建议参考 计费与用量。
创建与保护 API Key
API Key 在控制台创建。为了便于统计消耗和定位异常,建议为不同的客户端和设备分别创建独立的密钥,并在名称中注明用途。API Key 具有消费账户额度的权限,应当作为敏感凭据保护:
- 不要将密钥写入前端页面、移动端源码或公开的代码仓库中。
- 本地开发时应当将密钥保存在环境变量或
.env.local文件中,并确认该文件已被.gitignore规则忽略。 - 一旦怀疑密钥发生泄漏,应当立即在控制台删除旧密钥,创建新密钥后更新各客户端配置。
详细管理方法参考 账号与 API Key;后端代理与团队权限划分参考 安全建议。
保护 API Key 安全
拥有 API Key 即可消耗对应的账户额度。不要在即时通信群组中发送密钥明文,不要在截图或公开演示中展示密钥,也不要将包含密钥的文件提交至版本控制系统。
请求头要求
向 API 发起 HTTP 请求时,需要包含以下请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json如果请求头缺失或格式错误,接口会返回 401 Unauthorized。常见原因包括密钥未完整复制、Bearer 与密钥之间遗漏了半角空格,或者将密钥错误地填写到了其他参数字段中。具体排查步骤参考 故障排查。
接口列表
| 接口路径 | 功能说明 | 请求模式 |
|---|---|---|
GET /v1/models | 获取当前账号有权限调用的模型列表 | 同步 |
POST /v1/chat/completions | OpenAI Chat Completions 兼容对话接口 | 同步 / 流式 |
POST /v1/responses | OpenAI Responses 兼容接口,适用于新版工具及 Codex | 同步 / 流式 |
POST /v1/messages | Anthropic Messages 兼容接口,供 Claude Code 等工具使用 | 同步 / 流式 |
POST /v1/files | 上传视频生成所需的参考素材 | 同步 |
POST /v1/videos | 提交视频生成任务 | 异步 |
GET /v1/videos/{task_id} | 查询视频生成任务的执行状态 | 异步 |
GET /v1/videos/{task_id}/content | 下载已生成完成的视频文件 | 异步 |
对话接口和视频接口均以 https://console.anystarx.com/v1 作为基础地址,具体路由由客户端或代码库自动追加。完整参数定义与示例代码参考 API 概览。
同步与异步接口的区别:对话接口属于同步操作,发起请求后在当前 HTTP 响应中直接返回生成文本;视频生成属于异步任务,客户端先通过 POST /v1/videos 提交任务并取得任务编号,随后使用 GET /v1/videos/{task_id} 定期查询执行进度,当 status 变为 completed 后再通过下载接口获取视频内容。完整操作参考 视频生成。
用量监控与限速说明
控制台提供完整的余额变动、用量统计以及历史请求记录,包含请求发起时间、使用的模型 ID、输入参数和响应结果。如果发现用量突然出现异常增长,应当首先排查客户端是否在后台陷入了循环重试,排查方法参考 计费与用量。
历史请求数据和生成文件的保留周期,以及每个密钥对应的并发请求频率限制,均以控制台说明为准。当请求频率超出配额时,服务端会返回 429 Too Many Requests。遇到限速时,应当降低客户端并发数、减少自动化重试并加入退避等待时间,详细建议参考 故障排查。
技术支持
遇到常见错误时,可以优先查阅 FAQ 与 故障排查。针对 401、404、429 以及模型不存在等常见返回码,文档中均提供了直接的排查步骤。如果需要人工技术协助,可以通过控制台工单或网站底部的客服通道联系我们。
客户端配置
常用的 coding agent 工具可以参考以下步骤完成配置:
如果使用 Cursor、Raycast、Cherry Studio 等其他客户端,请查阅 全部客户端示例;通过编写代码接入的开发者请查阅 SDK 与框架;需要调用视频生成接口请查阅 视频生成。