provod.ai / docs
Начало работы

Начало работы с provod.ai

Выберите задачу или отправьте первый запрос Chat Completions без потоковой передачи.

Обновлено

Выберите нужный результат. Если вы впервые подключаете API, в конце быстрого старта вы получите настоящий ответ модели.

Выберите задачу

Отправьте первый запрос к API

Понадобятся curl и jq. Запрос использует Chat Completions без потоковой передачи и задаёт max_tokens равным 64, чтобы резерв для первого ответа был небольшим и предсказуемым.

Создайте и сразу скопируйте ключ

Откройте раздел API-ключи, создайте ключ и сразу скопируйте его полное значение. Повторно оно не показывается. Храните ключ в доверенной серверной среде и никогда не отправляйте его полностью в поддержку.

Terminal
set -euo pipefail

export PROVOD_API_KEY="sk_..."

Найдите доступную модель для чата

Запросите текстовые модели, у которых указан max_tokens. Команда также проверит доступность, исключит записи методов изображений и выведет точный идентификатор.

Terminal
if ! MODELS_JSON="$(
  curl --fail-with-body --silent --show-error "https://api.provod.ai/v1/models?output_modalities=text&supported_parameters=max_tokens" \
    -H "Authorization: Bearer $PROVOD_API_KEY"
)"; then
  printf '%s\n' "$MODELS_JSON" >&2
  exit 1
fi

if ! MODEL_ID="$(
  jq -er '
    first(
      .data[]
      | select(
          .available == true
          and ((.architecture.output_modalities // []) | index("text"))
          and ((.supported_parameters // []) | index("max_tokens"))
          and ((.supported_endpoint_types // []) | all(. != "image-generation" and . != "image-edit"))
        )
      | .id
    )
  ' <<<"$MODELS_JSON"
)"; then
  printf 'No available chat model with max_tokens found in /v1/models.\n' >&2
  exit 1
fi
export MODEL_ID
printf '%s\n' "$MODEL_ID"

Отправьте запрос без потоковой передачи

Terminal
curl --fail-with-body --silent --show-error https://api.provod.ai/v1/chat/completions \
  -H "Authorization: Bearer $PROVOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with ok\"}],\"max_tokens\":64,\"stream\":false}"

В успешном ответе текст модели находится в choices[0].message.content. При ошибке HTTP curl оставляет структурированный ответ видимым для диагностики. Сохраните в клиенте точный идентификатор из каталога, а не угадывайте его и не копируйте старый список моделей.

API-ключ получает доступную модель и ответ Chat Completions.

Перед первым запросом получите модель из текущего каталога.

Что делать дальше

На этой странице