Service API 接入 · 05

SDK 集成示例

4.1 Python(openai 官方 SDK)

bash
pip install openai
python
import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["JF_BASE_URL"],   # 部署方提供的 Base URL
    api_key=os.environ["JF_API_KEY"],     # 部署方提供的 sk-svc-...
)

# 流式
stream = client.chat.completions.create(
    model="ignored",                                # 字段必填,但服务端忽略
    messages=[{"role": "user", "content": "用 5 句话讲深度学习"}],
    stream=True,
    extra_body={"conversation_id": None},           # 首轮 None;后续填上一轮返回的 id
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

# 非流式 + 续会话
resp = client.chat.completions.create(
    model="x",
    messages=[{"role": "user", "content": "我叫小明"}],
    stream=False,
)
conv_id = resp.model_extra.get("conversation_id")   # ⚠️ 顶层扩展字段

resp = client.chat.completions.create(
    model="x",
    messages=[{"role": "user", "content": "我叫什么?"}],
    stream=False,
    extra_body={"conversation_id": conv_id},
)
print(resp.choices[0].message.content)

4.2 Node.js(openai npm)

bash
npm i openai
javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: process.env.JF_BASE_URL,
  apiKey: process.env.JF_API_KEY,
});

// 流式
const stream = await client.chat.completions.create({
  model: "ignored",
  messages: [{ role: "user", content: "用 5 句话讲深度学习" }],
  stream: true,
  // @ts-expect-error 扩展字段
  conversation_id: null,
});

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

4.3 curl(流式)

bash
curl -N -sS "$JF_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $JF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stream": true,
    "messages": [{"role": "user", "content": "用 5 句话讲深度学习"}]
  }'

-N 关掉 curl 自身的 buffering,能逐 chunk 看到 data: ...

4.4 LangChain / LlamaIndex / Cursor / 任意 OpenAI 兼容客户端

OPENAI_API_BASE 或客户端配置里的 base url 指到部署方提供的 $JF_BASE_URLOPENAI_API_KEYsk-svc-...model 字段填什么都行(会被忽略)。续会话靠业务侧自己保存 conversation_id