APIMaster.ai
Dokumentasi APIMaster.ai
Quick startAPIMaster.aiMarketplace

LangChain + APIMaster.ai

Gunakan API yang kompatibel dengan OpenAI dari APIMaster.ai di LangChain sebagai pengganti kunci quickstart resmi OpenAI.

LangChain adalah kerangka kerja populer untuk aplikasi LLM. APIMaster.ai menyediakan API yang kompatibel dengan OpenAI — atur model_provider="openai" dan arahkan base_url ke APIMaster.

Dapatkan Kunci API terlebih dahulu. Salin ID model yang tepat dari marketplace (misalnya gpt-5.4, claude-sonnet-4-6).

Prasyarat

  1. Python 3.10+ (3.11+ disarankan).
  2. Kunci API APIMaster dari konsol.
  3. ID model target dari marketplace.

Langkah 1 — Instal dependensi

pip install langchain langchain-openai httpx

Langkah 2 — Buat file contoh

Buat apimaster_quickstart.py:

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()

Anda juga dapat mengunduh skrip contoh dan menempelkan kunci Anda sebelum menjalankannya.

Langkah 3 — Jalankan

python apimaster_quickstart.py

Jika berhasil, Anda akan melihat output yang mirip dengan:

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

Agen memanggil alat get_weather dan mengembalikan balasan akhir.

Pengaturan utama

URL dasar APIMaster yang kompatibel dengan OpenAI:

https://apimaster.ai/v1

Konfigurasi inti LangChain:

model = init_chat_model(
    "gpt-5.4",
    model_provider="openai",
    api_key=APIMASTER_API_KEY,
    base_url="https://apimaster.ai/v1",
)
Parameter Nilai
model_provider "openai" (protokol yang kompatibel dengan OpenAI)
base_url https://apimaster.ai/v1
Nama model ID model dari Marketplace

Contoh GPT: MODEL_NAME = "gpt-5.4"
Contoh Claude: MODEL_NAME = "claude-sonnet-4-6"

Masalah proxy

Jika HTTP_PROXY / HTTPS_PROXY diatur secara lokal, Anda mungkin mengalami kesalahan SSL atau koneksi. Berikan:

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

Ini menghentikan httpx dari mengambil variabel env proxy sistem — berguna untuk pengujian lokal cepat. Konfigurasikan proxy secara eksplisit di produksi jika diperlukan.

Penanganan kunci yang lebih aman

Untuk proyek nyata, gunakan variabel lingkungan daripada menulis kunci secara hard-code:

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

Pemecahan masalah

Gejala Perbaikan
401 / Kunci API Tidak Valid Verifikasi kunci lengkap dan diaktifkan di konsol
404 / model tidak ditemukan MODEL_NAME harus cocok persis dengan ID model di marketplace
SSL / timeout Coba trust_env=False; periksa firewall/proxy
ModuleNotFoundError Jalankan pip install langchain langchain-openai httpx

Daftar periksa

  • Menginstal langchain, langchain-openai, httpx
  • base_url = https://apimaster.ai/v1
  • MODEL_NAME dari marketplace
  • Kunci API diatur (kode atau variabel env)
  • apimaster_quickstart.py berjalan dan mencetak output agen

Lihat juga