Справочник API

Базовый URL REST API: https://api.promptlayer-hub.com/v1

Аутентификация

Все запросы требуют API-ключ в заголовке Authorization:

Authorization: Bearer <your-api-key>

Промпты

GET /prompts

Список всех промптов в рабочем пространстве.

curl https://api.promptlayer-hub.com/v1/prompts \
  -H "Authorization: Bearer $API_KEY"

POST /prompts

Создать новую версию промпта.

{
  "name": "customer-support/greeting",
  "template": "Hello {{ customer_name }}...",
  "model": "claude-3-sonnet",
  "parameters": {"temperature": 0.7}
}

GET /prompts/{name}

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

PUT /prompts/{name}

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

DELETE /prompts/{name}

Архивировать промпт.

Выполнения

POST /executions

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

{
  "prompt_name": "customer-support/greeting",
  "variables": {"customer_name": "Alice"}
}

GET /executions/{id}

Получить данные выполнения: токены, стоимость, задержку.

Оценки

POST /evaluations

Запланировать запуск оценки.

GET /evaluations/{id}

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

Webhooks

POST /webhooks

Зарегистрировать webhook-эндпоинт.

DELETE /webhooks/{id}

Удалить webhook.

Ошибки

Все ошибки возвращаются в JSON:

{
  "error": {
    "code": "invalid_request",
    "message": "Prompt name is required"
  }
}

Коды статусов: 200, 201, 400, 401, 404, 429, 500.