图像、音频、视频与 Realtime

能力状态说明

实际可用能力以账号、模型及渠道配置为准。请先查询 /v1/models，再通过控制台或支持入口确认所选模型的接口、参数、价格与配额。

能力	接入路径	客户使用前提
图像生成	`POST /v1/images/generations`	需支持的模型、渠道或已配置任务插件
图像编辑	`POST /v1/images/edits`	同时确认 multipart/JSON、参考图、遮罩、尺寸与格式
语音转写	`POST /v1/audio/transcriptions`	需对应音频模型；文件上传格式与大小因渠道而异
音频翻译	`POST /v1/audio/translations`	需确认目标模型支持
语音合成	`POST /v1/audio/speech`	需对应 TTS 模型；音色、编码与流式能力因渠道而异
视频任务	`POST /v1/videos`、`GET /v1/videos/:task_id`	需匹配的视频渠道/任务插件；不可据此假设所有供应商使用同一参数
视频结果	`GET /v1/videos/:task_id/content`	需已有授权且完成的任务；是否支持取决于任务协议
Realtime	`wss://api.aimirrorx.com/v1/realtime?model=MODEL_ID`	需支持 Realtime 的渠道、模型与 WebSocket 客户端
Responses WebSocket	`wss://api.aimirrorx.com/v1/responses`	独立 Responses 协议，不是 Realtime 音频协议

图像示例

先确认所选模型支持 OpenAI Images 协议，再运行：

curl https://api.aimirrorx.com/v1/images/generations \
  -H "Authorization: Bearer $AIMIRRORX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"MODEL_ID_FROM_V1_MODELS","prompt":"一座安静的海边灯塔","n":1}'

返回值可能是 URL、base64 或异步任务对象，取决于协议与渠道。不要将提交成功当作生成完成；不要对不确定的任务自动重新提交。有效期、结果下载、轮询频率与计费规则以所选服务实际行为为准。

音频与视频

音频上传通常使用 multipart，语音合成通常返回二进制；不要统一按文本 JSON 解析。视频是任务流程，先提交、保存任务 ID、轮询状态，再下载结果。原生供应商路径可能不同，请使用该渠道明确给出的协议；本站不提供通用视频参数模板或开通承诺。

WebSocket 与浏览器

服务端 WebSocket 客户端可按接口要求使用 Bearer 鉴权；浏览器原生 WebSocket 无法任意设置请求头。不要在网页代码或 URL 中暴露长期 API 密钥；需要额外的受控服务端接入方案，不能假设支持原厂临时会话密钥、WebRTC 或全部事件类型。

不应假定支持的能力

/v1/images/variations、Files 与 Fine-tunes 等部分上游接口当前不支持。管理接口需要独立管理权限，不应使用客户令牌尝试管理渠道、用户或计费配置。上游插件市场属于参考资料，文档服务不提供插件安装或代理执行功能。