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 URLhttps://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/completionsOpenAI Chat Completions 兼容对话接口同步 / 流式
POST /v1/responsesOpenAI Responses 兼容接口,适用于新版工具及 Codex同步 / 流式
POST /v1/messagesAnthropic 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 与框架;需要调用视频生成接口请查阅 视频生成

入门指引

  1. 查阅 快速开始,确认账号创建、API Key 获取与首次请求连通。
  2. 查阅 模型与路由,了解模型 ID 的规范格式与复制方法。
  3. 按照所使用的工具类型,查阅 客户端示例SDK 与框架 完成实际接入。
  4. 调用过程中如果遇到错误响应,对照 故障排查 依据状态码定位原因。

本页内容