Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Tài liệu tham chiếu SDK

Tương thích OpenAI SDK

BazaarLink hoàn toàn tương thích với OpenAI Python và Node.js SDK. Chỉ cần hai thay đổi:

Trước (OpenAI trực tiếp)

1
2
3
4
5
6
7
8
9
10
from openai import OpenAI

client = OpenAI(
    api_key="sk-..."
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[...]
)

Sau (BazaarLink)

1
2
3
4
5
6
7
8
9
10
11
from openai import OpenAI

client = OpenAI(
    base_url="https://api.bazaarlink.ai/v1",
    api_key="sk-bl-YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="openai/gpt-4o",  # add provider/
    messages=[...]
)

Chỉ vậy thôi!

Tất cả tính năng khác — streaming, gọi công cụ, đầu ra có cấu trúc, async — hoạt động giống hệt. Thay đổi duy nhất là base_url, api_key, và thêm tiền tố nhà cung cấp vào ID mô hình.

Python

Cài đặt

1
pip install openai

Đồng bộ

1
2
3
4
5
6
7
8
9
10
11
12
13
from openai import OpenAI

client = OpenAI(
    base_url="https://api.bazaarlink.ai/v1",
    api_key="sk-bl-YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Bất đồng bộ

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://api.bazaarlink.ai/v1",
    api_key="sk-bl-YOUR_API_KEY",
)

async def main():
    response = await client.chat.completions.create(
        model="anthropic/claude-sonnet-4.6",
        messages=[{"role": "user", "content": "Hello async world!"}],
    )
    print(response.choices[0].message.content)

asyncio.run(main())

Streaming bất đồng bộ

1
2
3
4
5
6
7
8
9
10
11
12
async def stream_chat():
    stream = await client.chat.completions.create(
        model="deepseek/deepseek-chat",
        messages=[{"role": "user", "content": "Tell me a story"}],
        stream=True,
    )
    async for chunk in stream:
        content = chunk.choices[0].delta.content
        if content:
            print(content, end="", flush=True)

asyncio.run(stream_chat())

TypeScript / Node.js Tích hợp

Cài đặt

1
npm install openai

Sử dụng cơ bản

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.bazaarlink.ai/v1",
  apiKey: process.env.BAZAARLINK_API_KEY,
});

async function chat(message: string): Promise<string> {
  const response = await client.chat.completions.create({
    model: "openai/gpt-4o",
    messages: [{ role: "user", content: message }],
  });
  return response.choices[0].message.content ?? "";
}

Streaming

1
2
3
4
5
6
7
8
9
const stream = await client.chat.completions.create({
  model: "openai/gpt-4o",
  messages: [{ role: "user", content: "Tell me a story" }],
  stream: true,
});

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

LangChain

Sử dụng BazaarLink với LangChain bằng cách cấu hình base URL tương thích OpenAI.

1
2
3
4
5
6
7
8
9
10
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.bazaarlink.ai/v1",
    api_key="sk-bl-YOUR_API_KEY",
    model="anthropic/claude-sonnet-4.6",
)

response = llm.invoke("Explain BazaarLink in one sentence.")
print(response.content)

LlamaIndex

Sử dụng BazaarLink trong pipeline RAG LlamaIndex. LlamaIndex hỗ trợ bất kỳ endpoint tương thích OpenAI — chỉ cần thay đổi hai tham số.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
from llama_index.llms.openai import OpenAI
from llama_index.core import Settings

Settings.llm = OpenAI(
    model="openai/gpt-4o",
    api_base="https://api.bazaarlink.ai/v1",
    api_key="sk-bl-YOUR_API_KEY",
)

# Now use LlamaIndex normally — it calls BazaarLink
from llama_index.core import VectorStoreIndex, SimpleDirectoryReader

documents = SimpleDirectoryReader("./docs").load_data()
index = VectorStoreIndex.from_documents(documents)
query_engine = index.as_query_engine()
response = query_engine.query("What is this documentation about?")
print(response)

Vercel AI SDK

Tích hợp Vercel AI SDK với BazaarLink trong ứng dụng Next.js. Hỗ trợ streaming, gọi công cụ và đầu ra có cấu trúc.

Cài đặt

1
npm install ai @ai-sdk/openai

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

const bazaarlink = createOpenAI({
  baseURL: "https://api.bazaarlink.ai/v1",
  apiKey: "sk-bl-YOUR_API_KEY",
});

const { text } = await generateText({
  model: bazaarlink("openai/gpt-4o"),
  prompt: "Write a haiku about programming",
});

console.log(text);