SDK rehberleri
LangChain
LangChain'in OpenAI entegrasyonunu base URL ve anahtarı ayarlayarak api14 ile kullanın; Python ve JavaScript için akış, araçlar, structured output ve embedding.
LangChain'in OpenAI entegrasyonu api14 ile değişiklik yapmadan çalışır: base URL'i ve anahtarı ayarlayın, istediğiniz model kimliğini kullanın (örneğin openai/gpt-5-mini). Örnekler Python (langchain-openai) ve JavaScript (@langchain/openai) için gösterilmiştir.
Kurulum
pip install langchain-openai
# or
npm install @langchain/openai @langchain/core
export API14_API_KEY="sk-api14-..."
Yapılandırma (Python)
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="anthropic/claude-sonnet-4.5",
base_url="https://api14.com/api/v1",
api_key=os.environ["API14_API_KEY"],
)
print(llm.invoke("Explain vector databases in two sentences.").content)
Yapılandırma (JavaScript)
import { ChatOpenAI } from "@langchain/openai";
const llm = new ChatOpenAI({
model: "openai/gpt-5-mini",
apiKey: process.env.API14_API_KEY,
configuration: { baseURL: "https://api14.com/api/v1" },
});
const res = await llm.invoke("Explain vector databases in two sentences.");
console.log(res.content);
Streaming
for chunk in llm.stream("Write a haiku about APIs."):
print(chunk.content, end="", flush=True)
for await (const chunk of await llm.stream("Write a haiku about APIs.")) {
process.stdout.write(String(chunk.content));
}
Araçlar ve structured output
from pydantic import BaseModel
from langchain_core.tools import tool
@tool
def get_weather(city: str) -> str:
"""Get the current weather for a city."""
return f"21°C in {city}"
msg = llm.bind_tools([get_weather]).invoke("What is the weather in Istanbul?")
print(msg.tool_calls)
class Place(BaseModel):
city: str
country: str
place = llm.with_structured_output(Place).invoke('I live in Lisbon, Portugal.')
print(place)
Embeddings
api14'teki embedding modellerinin çoğu OpenAI modeli değildir; bu yüzden istemci tarafındaki tiktoken uzunluk kontrolünü kapatın:
from langchain_openai import OpenAIEmbeddings
embeddings = OpenAIEmbeddings(
model="openai/text-embedding-3-small",
base_url="https://api14.com/api/v1",
api_key=os.environ["API14_API_KEY"],
check_embedding_ctx_length=False,
)
vectors = embeddings.embed_documents(["The quick brown fox", "Lorem ipsum"])
Ağ geçidi parametreleri
Ağ geçidine özgü alanları extra_body (Python) veya modelKwargs (JS) ile geçin:
llm = ChatOpenAI(
model="openai/gpt-5-mini",
base_url="https://api14.com/api/v1",
api_key=os.environ["API14_API_KEY"],
extra_body={"models": ["anthropic/claude-sonnet-4.5"], "provider": {"sort": "price"}},
)
Hatalar
LangChain, OpenAI SDK istisnalarını yüzeye çıkarır. 402 insufficient_balance bir openai.APIStatusError fırlatır; 429 rate_limited ise yerleşik yeniden denemelerden (ChatOpenAI üzerinde max_retries=) sonra openai.RateLimitError fırlatır. Bkz. Hatalar.