Base URL 总览
NextAI Code 在同一个域名下提供 OpenAI、Anthropic、Gemini 等多种协议的接口,同一个 API Key 通用。按协议选对 Base URL 和鉴权头即可。
速查表
| 协议 | SDK 中填写的 Base URL | 主要路径 | 鉴权头 |
|---|---|---|---|
| OpenAI 兼容 | https://www.nextai-code.com/v1 |
/v1/chat/completions、/v1/responses、/v1/embeddings 等 |
Authorization: Bearer YOUR_API_KEY |
| Anthropic 兼容 | https://www.nextai-code.com |
/v1/messages、/v1/messages/count_tokens |
x-api-key: YOUR_API_KEY,建议同时带 anthropic-version: 2023-06-01 |
| Gemini 原生 | https://www.nextai-code.com |
/v1beta/models/{model}:generateContent 等 |
x-goog-api-key: YOUR_API_KEY 或 ?key=YOUR_API_KEY |
| OpenAI Realtime | wss://www.nextai-code.com/v1 |
/v1/realtime |
Authorization: Bearer YOUR_API_KEY,浏览器中用 WebSocket 子协议 |
| Midjourney | https://www.nextai-code.com |
/mj/submit/*、/mj/task/{id}/fetch |
Authorization: Bearer YOUR_API_KEY 或 mj-api-secret: YOUR_API_KEY |
所有接口都接受 Authorization: Bearer YOUR_API_KEY;表中其他鉴权头是为了兼容各家官方 SDK,只在对应协议的路径上生效。
Base URL 是否带
/v1:OpenAI SDK 只在 Base URL 后拼接/chat/completions等,所以必须带/v1;Anthropic、Google GenAI SDK 会自己拼接/v1/...、/v1beta/...,所以不要带/v1。
完整接口路径
OpenAI 兼容(/v1)
| 能力 | 方法与路径 |
|---|---|
| 模型列表 | GET /v1/models、GET /v1/models/{model} |
| Chat | POST /v1/chat/completions |
| Completions | POST /v1/completions |
| Responses | POST /v1/responses |
| 图片生成 / 编辑 | POST /v1/images/generations、POST /v1/images/edits |
| 图片异步任务 | GET /v1/images/tasks/{task_id} |
| 素材下载 | GET /v1/materials/{asset_key}/content |
| 向量 | POST /v1/embeddings |
| 排序 | POST /v1/rerank |
| 语音 | POST /v1/audio/speech、POST /v1/audio/transcriptions、POST /v1/audio/translations |
| 内容审核 | POST /v1/moderations |
| 视频 | POST /v1/videos、GET /v1/videos/{task_id}、GET /v1/videos/{task_id}/content |
| 视频(通用任务格式) | POST /v1/video/generations、GET /v1/video/generations/{task_id} |
| Realtime | GET /v1/realtime(WebSocket) |
以下 OpenAI 路径平台未提供,调用返回 501:/v1/files、/v1/fine-tunes、/v1/images/variations。
Anthropic 兼容
| 能力 | 方法与路径 |
|---|---|
| Messages | POST /v1/messages |
| 计算 Token | POST /v1/messages/count_tokens |
| 模型列表(Anthropic 格式) | GET /v1/models,同时带 x-api-key 与 anthropic-version |
Gemini 原生(/v1beta)
| 能力 | 方法与路径 |
|---|---|
| 生成内容 | POST /v1beta/models/{model}:generateContent |
| 流式生成 | POST /v1beta/models/{model}:streamGenerateContent |
| 模型列表(Gemini 格式) | GET /v1beta/models |
| 模型列表(OpenAI 格式) | GET /v1beta/openai/models |
厂商原生格式的任务接口
| 能力 | 方法与路径 |
|---|---|
| 可灵 | POST /kling/v1/videos/text2video、POST /kling/v1/videos/image2video 及对应 GET .../{task_id} |
| 即梦 | POST /jimeng/?Action=...&Version=... |
| Suno | POST /suno/submit/{action}、POST /suno/fetch、GET /suno/fetch/{id} |
| Midjourney | POST /mj/submit/imagine 等,GET /mj/task/{id}/fetch |
这些接口都用 Authorization: Bearer YOUR_API_KEY 鉴权。
鉴权方式
Bearer(通用)
Authorization: Bearer YOUR_API_KEY
Bearer 与 API Key 之间一个空格。API Key 带不带 sk- 前缀都能识别。
Anthropic:x-api-key
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
x-api-key 只在 /v1/messages、/v1/messages/count_tokens,以及带 anthropic-version 的 GET /v1/models 上生效;其他路径请用 Bearer。
Gemini:x-goog-api-key 或 key 参数
x-goog-api-key: YOUR_API_KEY
POST https://www.nextai-code.com/v1beta/models/gemini-3.8-flash:generateContent?key=YOUR_API_KEY
这两种写法用于 /v1beta/... 下的 Gemini 原生接口与模型列表;其他路径请用 Bearer。?key= 会出现在 URL 和访问日志中,服务端调用优先用请求头。
Realtime:WebSocket 子协议
服务端 / 脚本直接在握手请求中带 Authorization: Bearer YOUR_API_KEY。浏览器的 WebSocket 无法自定义请求头,可以把 API Key 放进子协议:
const ws = new WebSocket(
"wss://www.nextai-code.com/v1/realtime?model=YOUR_MODEL",
["realtime", "openai-insecure-api-key.YOUR_API_KEY", "openai-beta.realtime-v1"],
);
格式为 openai-insecure-api-key. 后接 API Key。这样会把 API Key 暴露在前端代码中,仅适合调试,或使用设置了额度上限、模型限制的专用 API Key。
Midjourney:mj-api-secret
兼容 midjourney-proxy 客户端:不带 Authorization 时,可以用以下请求头鉴权。
mj-api-secret: YOUR_API_KEY