Service API 接入 · 05
SDK 集成示例
4.1 Python(openai 官方 SDK)
bash
pip install openaipython
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 openaijavascript
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_URL,OPENAI_API_KEY 填 sk-svc-...,model 字段填什么都行(会被忽略)。续会话靠业务侧自己保存 conversation_id。