API 总览

InOneAPI 通过统一入口提供文本、图片、视频和音频能力。请求使用项目 API Key 认证，按公共模型 ID 路由到已启用的供应商映射，并在网关层完成协议兼容、计量、Trace 与异常保护。

基础地址

生产环境默认基础地址为 https://api.inoneapi.com/v1。所有服务端请求都应携带 Authorization: Bearer $INONEAPI_API_KEY；涉及 JSON 请求体的接口同时携带 Content-Type: application/json。

文本接口

文本能力用于对话、推理、工具调用和结构化输出等场景。当前 API 参考包含 POST /v1/chat/completions、POST /v1/responses 和 POST /v1/messages，分别覆盖 OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages 风格客户端。

图片接口

图片能力使用 OpenAI Images 兼容入口 POST /v1/images/generations。平台要求显式传入公共 model，并根据模型能力支持尺寸、质量、输出格式、透明背景、流式事件等参数。

视频接口

视频能力采用异步任务模型。POST /v1/videos 创建生成任务并返回任务 ID，GET /v1/videos/{id} 查询生成状态和产物。创建请求支持提示词、输入参考、时长、比例、清晰度和回调地址等公共字段。

音频接口

音频能力当前提供语音生成：POST /v1/audio/speech。请求遵循 OpenAI Speech JSON 协议，成功响应是音频字节而不是 JSON；调用方应按 MIME 类型保存或播放输出。

网关能力

每个请求都会经过 InOneAPI 网关的智能路由、异常流量检测、熔断、重试保护、Token 计量和请求级 Trace。排查问题时优先记录响应头 X-Gateway-Trace-ID，不要记录 API Key、完整提示词或敏感输出。