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(通用)

HTTP
Authorization: Bearer YOUR_API_KEY

Bearer 与 API Key 之间一个空格。API Key 带不带 sk- 前缀都能识别。

Anthropic:x-api-key

HTTP
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 参数

HTTP
x-goog-api-key: YOUR_API_KEY
CODE
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 放进子协议:

JAVASCRIPT
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 时,可以用以下请求头鉴权。

HTTP
mj-api-secret: YOUR_API_KEY

相关文档