Skip to main content

接口 v1 - 基础版

v1 接口提供 OpenAI Chat API 兼容的接口，支持多模型 AI 服务聚合。

概述​

v1 接口是基础版本，提供：

  • OpenAI Chat API 兼容：可直接使用 OpenAI SDK
  • 多模型聚合：支持众多主流 AI 提供商
  • 统一接口：一套接口访问所有模型
  • 简单认证：API Key 认证方式

基础信息​

Base URL​

https://your-dathor-instance.com/v1

认证方式​

使用 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

支持的端点​

模型列表​

  • GET /models - 获取可用模型列表

聊天对话​

  • POST /chat/completions - 创建聊天对话

文本嵌入​

  • POST /embeddings - 生成文本嵌入向量

图像生成​

  • POST /images/generations - 生成图像

音频处理​

  • POST /audio/transcriptions - 语音转文字
  • POST /audio/speech - 文字转语音

聊天对话​

创建对话​

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下雷驼智能引擎"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 1000
}

响应格式​

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "雷驼智能引擎是一个企业级多模型 AI API 聚合平台..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

流式响应​

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "请写一首关于春天的诗"
    }
  ],
  "stream": true
}

流式响应格式：

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1677652288,"model":"gpt-4o-mini","choices":[{"index":0,"delta":{"content":"春"},"finish_reason":null}]}

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1677652288,"model":"gpt-4o-mini","choices":[{"index":0,"delta":{"content":"天"},"finish_reason":null}]}

data: [DONE]

文本嵌入​

生成嵌入向量​

POST /v1/embeddings
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "text-embedding-3-small",
  "input": "雷驼智能引擎是一个多模型 AI API 聚合平台"
}

响应格式​

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, ...]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}

图像生成​

生成图像​

POST /v1/images/generations
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "dall-e-3",
  "prompt": "一只可爱的小猫在花园里玩耍",
  "n": 1,
  "size": "1024x1024",
  "quality": "standard"
}

响应格式​

{
  "created": 1677652288,
  "data": [
    {
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/...",
      "revised_prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，色彩鲜艳"
    }
  ]
}

音频处理​

语音转文字​

POST /v1/audio/transcriptions
Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

file: [音频文件]
model: whisper-1

文字转语音​

POST /v1/audio/speech
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "model": "tts-1",
  "input": "你好，欢迎使用雷驼智能引擎",
  "voice": "alloy"
}

SDK 支持​

雷驼智能引擎兼容 OpenAI Chat API 协议，您可以直接使用 OpenAI 官方 SDK 或任何兼容 OpenAI Chat API 的客户端库。

Python​

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://your-dathor-instance.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好！"}]
)
print(response.choices[0].message.content)

Node.js​

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "YOUR_API_KEY",
    baseURL: "https://your-dathor-instance.com/v1",
});

const response = await openai.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好！" }],
});

console.log(response.choices[0].message.content);

cURL​

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "你好！"}]}' \
  https://your-dathor-instance.com/v1/chat/completions

错误处理​

错误响应格式​

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

常见错误码​

错误码HTTP 状态码描述
invalid_api_key401API Key 无效
insufficient_quota429配额不足
rate_limit_exceeded429请求频率超限
model_not_found404模型不存在
invalid_request_error400请求参数错误

升级到接口 v8​

如果您需要更高级的功能，可以考虑升级到 接口 v8：

  • 持久化对话管理
  • 知识库集成
  • 高级工具调用
  • 复杂认证系统

查看 接口 v8 文档 →