API 接入与调用边界
从服务指南确认权限、模型、配额及任务能力,不混用凭据。
本页目录
开始前
API 首页提供 接入指南 和 管理入口。这是受限服务,首页可访问并不代表拥有账户或模型使用资格。
API 基础路径为 https://api.maximoraverse.org/v1。只使用管理员为该服务分配的独立应用密钥,不复用统一账户密码、DNS Token 或软件下载 Token。
核对模型与能力
先按原生指南验证应用密钥,再查询 /v1/models 与 /v1/capabilities 获取实际可用模型和功能。兼容入口包括 Responses 与 Chat Completions,但不要假定所有 OpenAI 参数或付费 API 功能都被支持。
当前实现对不支持的参数提供明确反馈;图片生成、音频和 Embeddings 等未配置能力可能返回 501,而非自动购买或切换付费服务。具体权限、参数与账户路由以原服务指南为准。
调用与费用核对
密钥通过授权头配置,存放在客户端密钥管理或环境变量中,不写入网页、仓库或日志。第一次先做最小请求,确认返回模型、内容与使用记录,再启用流式或工具调用。
遇到 401/403 先查凭据和权限;限额或临时错误查看返回提示。已经开始输出或执行工具的请求不要盲目重放,避免重复操作。冷却时间是重试提示,不是确定的配额恢复时间。
编码任务
有权限的用户可通过 /v1/tasks 提交任务、查看状态、取消并取得制品。任务与普通推理请求不同;提交前核对输入文件与预期产物。连接中断时先查原任务状态,不重复新建任务。
官方说明与帮助
完整兼容与能力说明是当前接入参数的维护入口。反馈错误码、时间和打码后的请求结构,不提供应用密钥或完整输入内容。
接入前后如何验收
仅配置 API 服务专用密钥,先查询当前可见模型与能力,再用无隐私的最小输入验证非流式返回、模型标识、错误码与使用记录。流式、工具、附件和任务分别测试,不因兼容 Responses/Chat Completions 就假定所有参数都实现。
HTTP 401/403 对应凭据或权限,429 对应限流或配额,5xx 需结合具体上游错误;以原接口消息为准,不把失败改写为成功,也不盲目切换到收费提供商。已经产生输出或执行外部动作的请求先查原记录,避免重复执行。
/v1/tasks 等异步能力只在该账户实际被授予时使用;断线先查询原任务,不另建重复任务。示例仅用占位符,反馈请求 ID、时间与脱敏结构,不上传应用密钥、完整提示词、文件或上游原始日志。
原生 API 指南仍是兼容参数与能力开关的维护入口;文档可访问不代表账户已获授权。