API 参考¶

API Nexus 提供兼容 OpenAI 格式的 REST API 接口，支持所有主流大模型。

基础信息¶

项	值
API Base URL	`https://apinexus.net/v1`
认证方式	Bearer Token
数据格式	JSON
字符编码	UTF-8

认证¶

所有 API 请求需要在 Header 中包含 API Key：

Authorization: Bearer nxk-你的APIKey

错误码¶

HTTP 状态码	说明
400	请求参数错误
401	API Key 无效或已过期
429	请求频率超限，请稍后重试
500	服务器内部错误
503	服务暂时不可用

错误响应格式¶

{
  "error": {
    "message": "错误描述",
    "type": "error_type",
    "code": "error_code"
  }
}

速率限制¶

不同接口有不同的速率限制：

接口	限制
对话 (chat/completions)	60 次/分钟
图像生成 (images/generations)	10 次/分钟
Embedding (embeddings)	100 次/分钟
语音合成 (audio/speech)	60 次/分钟

超出限制会返回 429 错误，建议实现指数退避重试机制。

API 端点¶

对话补全¶

POST /v1/chat/completions

支持 GPT、Claude、DeepSeek、GLM、Qwen 等所有对话模型。

图像生成¶

POST /v1/images/generations

支持 DALL-E、Flux、Seedream 等图像生成模型。

Embedding 向量¶

POST /v1/embeddings

生成文本的向量表示，用于相似度计算和检索。

语音合成¶

POST /v1/audio/speech

将文本转换为语音输出。

语音识别¶

POST /v1/audio/transcriptions

将语音转换为文本。

模型列表¶

GET /v1/models

获取所有可用模型的列表。

Python SDK 使用¶

from openai import OpenAI

client = OpenAI(
    api_key="nxk-你的APIKey",
    base_url="https://apinexus.net/v1"
)

# 对话
response = client.chat.completions.create(
    model="gpt-4o-mini-2024-07-18",
    messages=[{"role": "user", "content": "你好"}]
)

# Embedding
response = client.embeddings.create(
    model="text-embedding-3-small",
    input="要向量化的文本"
)

# 图像生成
response = client.images.generate(
    model="doubao-seedream-4-0-250828",
    prompt="一只可爱的猫",
    size="1024x1024"
)

完整 API 文档¶

本参考文档涵盖了主要接口的使用方法。各模型的详细调用说明请参考对应的教程文档：

文本对话：./tutorials/chat.md
图像生成：./tutorials/image.md
向量生成：./tutorials/embedding.md
音频处理：./tutorials/audio.md
多模态识图：./tutorials/vision.md

最后更新: 2026-06-16