Python SDK

Установка

pip install promptlayer-hub

Требуется Python 3.9+.

Инициализация клиента

from promptlayer_hub import Client

client = Client(
    api_key="your-key",
    base_url="https://api.promptlayer-hub.com/v1",  # опционально
    timeout=30,  # секунды
)

Методы

client.run(prompt_name, variables=None)

Выполнить промпт по имени.

result = client.run(
    prompt_name="support/greeting",
    variables={"name": "Alice"},
)
print(result.response)
print(result.cost_usd)
print(result.latency_ms)

client.prompts.get(name)

Получить определение промпта.

prompt = client.prompts.get("support/greeting")
print(prompt.template)
print(prompt.version)

client.prompts.create(name, template, model, parameters=None)

Создать новый промпт.

client.prompts.update(name, template=None, parameters=None)

Обновить промпт (создаётся новая версия).

client.evaluations.start(prompt_name, evaluator, rubric=None)

Запустить оценку.

client.evaluations.get(evaluation_id)

Получить результаты оценки.

Обработка ошибок

from promptlayer_hub import Client, APIError, RateLimitError

try:
    result = client.run(prompt_name="missing")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except APIError as e:
    print(f"API error: {e.code} — {e.message}")

Асинхронный клиент

from promptlayer_hub import AsyncClient

async def main():
    client = AsyncClient(api_key="your-key")
    result = await client.run("support/greeting", {"name": "Alice"})
    print(result.response)