OpenAI 兼容接口

复用现有 OpenAI SDK、LangChain 或 Chat UI,通过标准 POST /v1/chat/completions 直接消费 ApeMind Agent 的同步或流式回答。完整 Schema 见 API 参考。

入口与关键约定

Python OpenAI SDK 示例

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APEMIND_API_KEY"],
    base_url=f"{os.environ['APEMIND_BASE_URL']}/v1",
)

# 流式调用(同步调用改为 stream=False 并读取 response.choices[0].message.content)
stream = client.chat.completions.create(
    model="apemind",
    messages=[{"role": "user", "content": "请说明合同解除条件。"}],
    stream=True,
    extra_query={
        "bot_id": os.environ["APEMIND_AGENT_ID"],
        "language": "zh-CN",
    },
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

TypeScript / Node OpenAI SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.APEMIND_API_KEY,
  baseURL: `${process.env.APEMIND_BASE_URL}/v1`,
});

const stream = await client.chat.completions.create(
  {
    model: "apemind",
    messages: [{ role: "user", content: "请说明合同解除条件。" }],
    stream: true,
  },
  {
    query: {
      bot_id: process.env.APEMIND_AGENT_ID!,
      language: "zh-CN",
    },
  },
);

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content;
  if (delta) process.stdout.write(delta);
}

多轮连续对话

省略 chat_id 时,服务端为每次请求创建临时会话。需要复用 ApeMind 持久化多轮上下文时,先调用 POST /api/v2/bots/{agent_id}/chats 获取 chat_id,再把同一个 chat_id 放到后续调用的查询参数里:

curl --fail-with-body \
  -X POST "${APEMIND_BASE_URL}/v1/chat/completions?bot_id=${APEMIND_AGENT_ID}&chat_id=${CHAT_ID}&language=zh-CN" \
  -H "Authorization: Bearer ${APEMIND_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "apemind",
    "messages": [{"role": "user", "content": "继续说明违约责任。"}],
    "stream": false
  }'

同一条业务链路不要混用临时会话和显式 chat_id 持久会话。

错误处理与能力边界

下一步