Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Geeknow API 文档

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

文字系列

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

图像系列

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

视频系列

/v1/video/generations、/v1/videos、/kling/v1/*、/jimeng、/sora/v1/*。

音频系列

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

上传管理

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

账户管理

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

​
快速开始

curl -X POST https://www.geeknow.top/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。查询时再映射回真实上游任务。
如果你在文档里同时看到 /v1/videos/{task_id} 和 /v1/video/generations/{task_id}，前者是 OpenAI 视频兼容查询接口，后者是平台统一任务查询接口，它们对应同一批视频任务但返回结构不同。

​
路由来源

文件主要覆盖内容
router/relay-router.go/v1、/v1beta、/pg、/mj、/suno 等文本、图像、音频和任务路由
router/video-router.go/v1/video/generations、/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. 账户管理概览