INTEGRITY Документация

← Cloudflare AI Gateway / ai-gateway / tutorials

Использование Pruna P-video через AI Gateway

Этот туториал показывает, как вызвать P-video от Pruna ↗ модель на Replicate через AI Gateway.

Предварительные требования

1. Получение API-токена Replicate

  1. Перейдите в replicate.com ↗ и зарегистрируйте аккаунт.
  2. После входа перейдите в replicate.com/settings/api-tokens ↗.
  3. Выберите Создать токен и присвойте ему имя.
  4. Скопируйте токен и сохраните его в надёжном месте.

2. Создание AI Gateway

Перейдите в AI Gateway ↗
  1. Войдите в Панель управления Cloudflare ↗ и выберите свой аккаунт.
  2. Перейдите в AI > AI Gateway.
  3. Выберите Create Gateway.
  4. Введите свой Название шлюза. Примечание: имя шлюза ограничено 64 символами.
  5. В Биллинг Workers AI, выберите, как будут оплачиваться запросы к Workers AI через этот шлюз:
    • Стандартный биллинг списывает средства с вашего аккаунта Cloudflare в конце каждого платёжного цикла.
    • Единый биллинг списывается с баланса предоплаченных кредитов AI Gateway в режиме реального времени.
  6. Выберите Создание.

Чтобы настроить AI Gateway через API:

  1. Создание API-токена со следующими разрешениями:

    • AI Gateway - Read
    • AI Gateway - Edit

  2. Получите ваш Account ID.

  3. Используя этот API-токен и Account ID, отправьте POST запрос в Cloudflare API.

Запишите свой Account ID и Название шлюза для использования на следующих шагах.

Чтобы добавить аутентификацию к своему шлюзу, см. Аутентифицированный Gateway.

3. Формирование URL шлюза

Замените стандартный базовый URL API Replicate на URL AI Gateway:

# Instead of:
https://api.replicate.com/v1

# Use:
https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/replicate

Например, если ваш account ID abc123 и ваш шлюз my-gateway:

https://gateway.ai.cloudflare.com/v1/abc123/my-gateway/replicate

4. Генерация видео

Прогнозы P-video обычно завершаются в течение 30 секунд. Поскольку это укладывается в 60-секундный лимит синхронного выполнения Replicate, вы можете использовать Prefer: wait заголовок, чтобы отправить запрос и получить результат за один вызов:

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/replicate/predictions \
  --header "Authorization: Bearer {replicate_api_token}" \
  --header "cf-aig-authorization: Bearer {cloudflare_api_token}" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait" \
  --data '{
    "version": "prunaai/p-video",
    "input": {
      "prompt": "A cat walking through a field of flowers in slow motion",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "fps": 24
    }
  }'

Полный список доступных входных параметров см. в страница модели prunaai/p-video ↗ на Replicate.

После завершения предсказания ответ включает output поле с URL сгенерированного видеофайла.

5. (Необязательно) Асинхронный опрос для длительных запросов

Если ваш запрос может занять более 60 секунд (например, при большей длительности или более высоком разрешении), используйте вместо этого асинхронный режим (async mode). Отправьте запрос без Prefer: wait заголовок:

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/replicate/predictions \
  --header "Authorization: Bearer {replicate_api_token}" \
  --header "cf-aig-authorization: Bearer {cloudflare_api_token}" \
  --header "Content-Type: application/json" \
  --data '{
    "version": "prunaai/p-video",
    "input": {
      "prompt": "A cat walking through a field of flowers in slow motion",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "fps": 24
    }
  }'

Ответ включает предсказание id:

{
  "id": "xyz789...",
  "status": "starting",
  "urls": {
    "get": "https://api.replicate.com/v1/predictions/xyz789...",
    "cancel": "https://api.replicate.com/v1/predictions/xyz789.../cancel"
  }
}

Опрашивайте статус предсказания, пока он не завершится:

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/replicate/predictions/{prediction_id} \
  --header "Authorization: Bearer {replicate_api_token}" \
  --header "cf-aig-authorization: Bearer {cloudflare_api_token}"

Продолжайте опрашивать, пока status это succeeded (или failed). По завершении output поле содержит URL сгенерированного видеофайла.

Следующие шаги

Здесь вы можете: