快速开始

智信聚合兼容 OpenAI 风格的 REST API。创建 API Key 后，将现有 SDK 的 Base URL 替换为下方地址，即可按已开通的模型发送请求。

接入步骤

1. 登录控制台并创建 API Key。
2. 在模型广场确认可用模型名称。
3. 请求时带上 Authorization: Bearer YOUR_API_KEY。
4. 将 Base URL 配置为 https://zhixinapi.de5.net/v1。

认证方式

每次 API 请求都必须使用 Bearer Token 认证。请不要在前端网页、公开仓库或截图中暴露 API Key。

查询可用模型

调用前建议先查询模型列表。响应中的 id 即为请求体内的 model 值。

{
  "object": "list",
  "data": [
    {"id": "gpt-4o-mini", "object": "model"}
  ]
}

聊天接口

用于多轮对话、文本生成、工具调用等场景。消息按顺序传入，最后一条通常为 user 消息。

Body 参数

messages 结构

流式响应

传入 "stream": true 后，服务会返回 text/event-stream。每个事件以 data: {...} 开头，结束时收到 data: [DONE]。

data: {"choices":[{"delta":{"content":"你好"}}]}

data: {"choices":[{"delta":{"content":"，有什么可以帮你？"}}]}

data: [DONE]

内容补全接口

面向传统 Completion 格式的兼容接口。新项目优先使用聊天接口，便于统一处理系统提示词和多轮上下文。

向量生成

将文本转换为向量，用于语义检索、RAG、聚类和相似度比较。请选择已启用的 embedding 模型。

{
  "object": "list",
  "data": [{"object":"embedding","index":0,"embedding":[0.012,-0.031]}],
  "model": "text-embedding-3-small",
  "usage": {"prompt_tokens": 3, "total_tokens": 3}
}

图片生成

使用已开通的图片模型生成图像。不同模型支持的尺寸、质量参数和返回格式可能不同，请以控制台中可用模型为准。

文本编辑接口

根据指令改写、扩展或纠正输入文本。该接口由兼容层提供，实际可用模型和参数以控制台配置为准。

{
  "object": "edit",
  "choices": [{"text": "修改后的文本", "index": 0}],
  "usage": {"prompt_tokens": 8, "completion_tokens": 5, "total_tokens": 13}
}

请求示例代码

curl https://zhixinapi.de5.net/v1/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"text-davinci-edit-001","input":"这是一段文本","instruction":"请修正错别字"}'

文本转音频

将文本提交给已开通的语音模型，返回音频二进制流。该接口对应标准 OpenAI Audio API；参考页中的 API2D 私有路径 /azure/tts 在本站不提供。

请求示例代码

curl https://zhixinapi.de5.net/v1/audio/speech \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tts-1","input":"你好，欢迎使用智信聚合。","voice":"alloy","response_format":"mp3"}' \
  -o speech.mp3

音频转文本

上传音频文件并转写为原语言文本。请求使用 multipart/form-data，不要手动固定 Content-Type 的 boundary。

{
  "text": "这是音频转写后的文本。"
}

请求示例代码

curl https://zhixinapi.de5.net/v1/audio/transcriptions \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@audio.mp3" \
  -F "model=whisper-1" \
  -F "language=zh" \
  -F "response_format=json"

音频翻译为英文

上传非英文音频并翻译成英文文本。参数格式与音频转文本相同，接口会将结果统一输出为英文。

{
  "text": "This is the translated English text."
}

请求示例代码

curl https://zhixinapi.de5.net/v1/audio/translations \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@audio.mp3" \
  -F "model=whisper-1" \
  -F "response_format=json"

响应格式

成功请求返回 2xx 状态码。聊天接口的主要结果位于 choices[0].message.content，Token 使用量位于 usage。上游模型返回的扩展字段会按兼容格式透传。

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1760000000,
  "model": "gpt-4o-mini",
  "choices": [{
    "index": 0,
    "message": {"role":"assistant","content":"你好，有什么可以帮你？"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 12, "completion_tokens": 9, "total_tokens": 21}
}

错误码

非 2xx 响应请优先读取 error.message。错误原因可能来自 API Key、账户额度、模型权限、请求参数或上游服务。

使用建议

• 为不同应用创建独立 API Key，便于设置额度、追踪用量和快速撤销。
• 遇到 429 或短暂 5xx 时，使用指数退避重试，避免立即高频重放。
• 流式请求应持续读取响应直到 [DONE]，客户端超时应大于预期生成时间。
• 模型名称、上下文窗口和工具调用能力以控制台实际开通配置为准。