Документация API Ссылка SDK Ссылка Агентное использование AI Навыки

Видео

Отправьте заявку на создание видео

Отправляет задание асинхронного создания видео. Немедленно возвращает 202 с идентификатором задания (с префиксом vjob_); опросите GET /api/v1/videos/{id}, пока статус не будет завершен, затем загрузите через unsigned_urls. Выставление счетов: кредиты резервируются при отправке, исходя из продолжительности × разрешения и рассчитываются по фактически доставленным секундам (usage.cost в ответе на опрос).

POST/api/v1/videos

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

modelобязательно

string

Идентификатор модели создания видео (указывается поставщиком).

Example: "alibaba/wan2.7-t2v"

promptобязательно

string

Текстовое приглашение с описанием создаваемого видео.

duration

integer

Продолжительность видео в секундах. По умолчанию 2. Каждая модель имеет более жёсткие границы — например. ссылка на видео (r2v) допускает 2–10 с; Значения вне диапазона возвращают 400, прежде чем будут зарезервированы какие-либо кредиты.

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

Уровень качества вывода, по умолчанию «720p». Поддерживаемые уровни различаются в зависимости от модели; неподдерживаемый уровень возвращает 400, прежде чем какие-либо кредиты будут зарезервированы, и в ошибке перечислены уровни, которые поддерживает модель.

480p720p1080p

Example: "720p"

aspect_ratio

string

Соотношение сторон. Общие значения: «16:9», «9:16», «1:1», «4:3», «3:4»; точный набор зависит от модели (некоторые также используют широкие передаточные числа, например «21:9»). Неподдерживаемые комбинации возвращают 400 перед резервированием кредитов; режимы, которые принимают входной кадр, получают соотношение из кадра и игнорируют это поле.

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

Изображения первого/последнего ключевого кадра (изображение-видео, ключевой кадр-видео). Принимает пустые строки URL или объекты { type: "image", image_url: { url },frame_type: "first" | "последний" }.

input_references

object[] | string[]

Ссылочные ресурсы (ссылка на видео): создание руководства с использованием ссылочных элементов — отдавайте предпочтение объектной форме { type: "image", image_url: { url } } (голые строки URL также принимаются и рассматриваются как ссылки на изображения). Ссылки на изображения поддерживаются наиболее широко; Ссылочные объекты аудио/видео пересылаются «как есть» и действуют только на те модели, которые их поддерживают — другие модели используют ссылки на изображения и игнорируют остальные. Это поле принимают только модели с режимом r2v.

input_video

string | object

Исходное видео (только модели с возможностью редактирования видео; поле расширения BazaarLink). Принимает строку URL, { video_url: { url } } или { url }. Игнорируется моделями без редактирования видео. Редактирование счетов по исходным секундам + доставленным выходным секундам.

generate_audio

boolean

Генерировать ли также звук. Действует только на моделях с поддержкой звука; счет за аудиосекунды осуществляется по более высокой посекундной ставке.

watermark

boolean

Добавлять ли водяные знаки на вывод. По умолчанию false — BazaarLink активно отключает водяные знаки по умолчанию, если вы явно не укажете true.

seed

number

Отбор семян. Гарантии воспроизводимости зависят от модели.

callback_url

string

Веб-перехватчик URL вызывает состояние терминала задания, поэтому опрос не требуется. Только HTTPS и проверка SSRF (частные/внутренние адреса отклонены) перед резервированием каких-либо кредитов. Срабатывает ровно один раз, только из запроса, выигравшего определение состояния терминала; Доставка повторяется в случае неудачи (2 попытки, отсрочка 2/8 секунд), а утомительные повторные попытки никогда не влияют на выставление счетов или реальный статус задания. В версии 1 нет подписи — воспринимайте обратный вызов как подсказку и подтвердите статус/сумму, вызвав GET /v1/videos/{id} с помощью ключа API, прежде чем действовать по нему. ⚠️ unsigned_urls в полезных данных веб-перехватчика являются абсолютными URL-адресами, в отличие от относительных путей, возвращаемых конечной точкой опроса.

https:// only, ≤2048 chars

Подробное руководство →

POST /api/v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://bazaarlink.ai/api/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan2.7-t2v",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Примеры ответов

Задание принято (асинхронно). Опросить возвращенный polling_url (т. е. GET /api/v1/videos/{id}) на предмет статуса; рекомендуется интервал ≥5 с.

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}