多元探索 API 文档

基于 router/ 实际路由整理的 Mintlify 文档入口，覆盖文本、图像、视频、音频、上传、任务和账户接口。

多元探索 API 文档

这套文档直接对应仓库里的真实路由，优先以 router/、controller/、dto/ 为准，不按外部平台文档猜测接口行为。

文字系列

/v1/chat/completions、/v1/responses、/v1/messages、/v1beta/models/* 等文本与多模态接口。

图像系列

/v1/images/*、/mj/* 和 Gemini 原生图像能力的路由总览。

视频系列

按模型系列整理的视频能力，当前先提供 Grok 视频的生成与查询文档。

音频系列

/v1/audio/transcriptions、/v1/audio/translations、/v1/audio/speech、/suno/*。

上传管理

/api/upload/presign 的预签名上传能力，用于图片、视频和媒体资源预上传。

账户管理

Bearer Token、原生兼容认证头、OAuth 状态码和余额查询接口。

快速开始

curl -X POST https://zx1.deepwl.net/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "用三句话介绍 new-api 这套网关。" }
    ]
  }'

文档约定

• Relay 路由主要位于 /v1、/v1beta、/mj、/suno、/kling/v1，大多返回 OpenAI 兼容结构或上游原生结构，并使用真实 HTTP 状态码。
• Dashboard 与账户类接口主要位于 /api/*，很多接口使用统一包装：success、message、data。这类接口即使业务失败，也可能仍返回 HTTP 200。
• 异步任务接口提交后通常返回公开 task_id 或 OpenAI 兼容 video id。查询时再映射回真实上游任务。

路由来源

文件	主要覆盖内容
router/relay-router.go	/v1、/v1beta、/pg、/mj、/suno 等文本、图像、音频和任务路由
router/video-router.go	/v1/videos、/kling/v1、/jimeng、/sora/v1 等视频相关路由
router/api-router.go	/api/upload/presign、/api/oauth/*、/api/usage/token、用户和后台接口
router/dashboard.go	/dashboard/billing/* 与 /v1/dashboard/billing/* 兼容余额接口

推荐阅读顺序

1. 文字系列概览
2. 视频系列概览
3. 任务管理概览
4. 账户管理概览