APIMaster.ai
APIMaster.ai Belgeleri
Quick startAPIMaster.aiMarketplace

LangChain + APIMaster.ai

APIMaster.ai OpenAI uyumlu API'sini LangChain'de, resmi OpenAI hızlı başlangıç anahtarı yerine kullanın.

LangChain popüler bir LLM uygulama çerçevesidir. APIMaster.ai, OpenAI uyumlu bir API sunar — model_provider="openai" ayarlayın ve base_url'i APIMaster'a yönlendirin.

Önce bir API Anahtarı alın. Marketplace üzerinden tam model kimliğini kopyalayın (ör. gpt-5.4, claude-sonnet-4-6).

Gereksinimler

  1. Python 3.10+ (3.11+ önerilir).
  2. Konsoldan bir APIMaster API Anahtarı (console).
  3. Marketplace üzerinden bir hedef model kimliği.

Adım 1 — Bağımlılıkları yükleyin

pip install langchain langchain-openai httpx

Adım 2 — Örnek dosyayı oluşturun

apimaster_quickstart.py dosyasını oluşturun:

import httpx

from langchain.agents import create_agent
from langchain.chat_models import init_chat_model


APIMASTER_API_KEY = "your APIMaster.ai key"
APIMASTER_BASE_URL = "https://apimaster.ai/v1"
MODEL_NAME = "gpt-5.4"


def get_weather(city: str) -> str:
    """Get weather for a given city."""
    return f"It's always sunny in {city}!"


def main() -> None:
    model = init_chat_model(
        MODEL_NAME,
        model_provider="openai",
        api_key=APIMASTER_API_KEY,
        base_url=APIMASTER_BASE_URL,
        http_client=httpx.Client(trust_env=False, timeout=60),
        timeout=60,
    )

    agent = create_agent(
        model=model,
        tools=[get_weather],
        system_prompt="You are a helpful assistant",
    )

    result = agent.invoke(
        {"messages": [{"role": "user", "content": "What's the weather in San Francisco?"}]}
    )

    print(result["messages"][-1].content_blocks)


if __name__ == "__main__":
    main()

Ayrıca örnek betiği indirebilir ve çalıştırmadan önce anahtarınızı yapıştırabilirsiniz.

Adım 3 — Çalıştırın

python apimaster_quickstart.py

Başarılı olursa aşağıdakine benzer bir çıktı görmelisiniz:

[{'type': 'text', 'text': "It's always sunny in San Francisco!"}]

Ajan, get_weather aracını çağırır ve son yanıtı döndürür.

Anahtar ayarlar

APIMaster OpenAI uyumlu temel URL:

https://apimaster.ai/v1

Temel LangChain yapılandırması:

model = init_chat_model(
    "gpt-5.4",
    model_provider="openai",
    api_key=APIMASTER_API_KEY,
    base_url="https://apimaster.ai/v1",
)
Parametre Değer
model_provider "openai" (OpenAI uyumlu protokol)
base_url https://apimaster.ai/v1
Model adı Marketplace model kimliği

GPT örneği: MODEL_NAME = "gpt-5.4"
Claude örneği: MODEL_NAME = "claude-sonnet-4-6"

Proxy sorunları

Yerel olarak HTTP_PROXY / HTTPS_PROXY ayarlanmışsa, SSL veya bağlantı hatalarıyla karşılaşabilirsiniz. Şu parametreyi ekleyin:

http_client=httpx.Client(trust_env=False, timeout=60)

Bu, httpx'in sistem proxy ortam değişkenlerini almasını engeller — hızlı yerel testler için kullanışlıdır. Gerekirse üretimde proxy'leri açıkça yapılandırın.

Daha güvenli anahtar yönetimi

Gerçek projelerde anahtarları kod içine yazmak yerine ortam değişkenlerini kullanın:

import os

APIMASTER_API_KEY = os.environ["APIMASTER_API_KEY"]
APIMASTER_BASE_URL = "https://apimaster.ai/v1"

export APIMASTER_API_KEY="your key"
python apimaster_quickstart.py

Windows PowerShell:

$env:APIMASTER_API_KEY="your key"
python apimaster_quickstart.py

Sorun Giderme

Belirti Çözüm
401 / Geçersiz API Anahtarı Anahtarın eksiksiz olduğunu ve konsolda etkinleştirildiğini doğrulayın
404 / model bulunamadı MODEL_NAME marketplace model kimliği ile tam olarak eşleşmelidir
SSL / zaman aşımı trust_env=False deneyin; güvenlik duvarı/proxy kontrol edin
ModuleNotFoundError pip install langchain langchain-openai httpx komutunu çalıştırın

Kontrol Listesi

  • langchain, langchain-openai, httpx yüklendi
  • base_url = https://apimaster.ai/v1
  • MODEL_NAME marketplace üzerinden alındı
  • API Anahtarı ayarlandı (kod veya ortam değişkeni)
  • apimaster_quickstart.py çalışıyor ve ajan çıktısını yazdırıyor

Ayrıca bakınız