curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "pixverse-v6-max",
"prompt": "A blue glass marble rolls across a clean white table in morning light",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json={
"model": "pixverse-v6-max",
"prompt": "A blue glass marble rolls across a clean white table in morning light",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": True
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "pixverse-v6-max",
prompt: "A blue glass marble rolls across a clean white table in morning light",
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
audio: true
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
PixVerse V6 Max
PixVerse V6 Max Генерация видео
Генерация видео по тексту и одному изображению в 360p / 540p / 720p / 1080p, длительностью 1–15 секунд, с необязательным нативным звуком.
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "pixverse-v6-max",
"prompt": "A blue glass marble rolls across a clean white table in morning light",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json={
"model": "pixverse-v6-max",
"prompt": "A blue glass marble rolls across a clean white table in morning light",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": True
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "pixverse-v6-max",
prompt: "A blue glass marble rolls across a clean white table in morning light",
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
audio: true
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
Этот эндпоинт работает асинхронно. После отправки используйте полученный
task_id в GET /v1/videos/generations/{task_id}, чтобы узнать статус и результат задачи.curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "pixverse-v6-max",
"prompt": "A blue glass marble rolls across a clean white table in morning light",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}'
import requests
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json={
"model": "pixverse-v6-max",
"prompt": "A blue glass marble rolls across a clean white table in morning light",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": True
}
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "pixverse-v6-max",
prompt: "A blue glass marble rolls across a clean white table in morning light",
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
audio: true
})
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
Возможности модели
PixVerse V6 Max — версия PixVerse V6 с повышенным качеством изображения. Поддерживается только генерация по тексту и одному изображению, в обоих случаях с именем моделиpixverse-v6-max.
| Режим | Входные данные | Соотношение сторон |
|---|---|---|
| Генерация по тексту | Не передавайте image_urls; prompt обязателен | Используется aspect_ratio, по умолчанию 16:9 |
| Генерация по изображению | Передайте 1 изображение в image_urls; prompt необязателен | Следует за входным изображением; aspect_ratio не действует |
Заголовки запроса
string
обязательно
Аутентификация Bearer:
Bearer <token>, где <token> — ваш API-ключ APIMart.Параметры запроса
string
обязательно
Должно быть
pixverse-v6-max.string
Описание содержимого для генерации. Обязательно при генерации по тексту, до 5000 символов; необязательно при генерации по изображению, до 2048 символов.
string[]
Список URL входных изображений. Генерация по изображению принимает ровно 1 изображение; передача 2 и более синхронно возвращает HTTP 400. Для генерации по тексту не передавайте это поле.Изображение должно быть общедоступно по HTTP(S), в формате JPEG, PNG или WebP, размером менее 20 MB, с длиной каждой стороны не более 10000 пикселей.
integer
по умолчанию:"5"
Длительность результата в секундах: от
1 до 15, по умолчанию 5.string
по умолчанию:"540p"
Разрешение результата:
360p, 540p, 720p или 1080p; по умолчанию 540p.Результат использует нативные размеры модели поставщика; ориентируйтесь на фактически возвращённые размеры. Примеры, наблюдавшиеся в тестах: 640×360 и 1108×832 (ширина × высота, в пикселях).Также принимается поле quality. Если переданы оба поля, приоритет у resolution.string
Поле совместимости для разрешения с теми же значениями, что у
resolution. Используется только при отсутствии resolution; если оба поля не заданы, применяется 540p.string
по умолчанию:"16:9"
Действует только при генерации по тексту. Поддерживаются
16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 и 21:9; по умолчанию 16:9.При генерации по изображению всегда используется его соотношение сторон; это поле не действует.boolean
по умолчанию:"false"
Укажите
true для генерации нативного звука; по умолчанию видео без звука. Генерация со звуком имеет более высокую цену за секунду.Учитывается только audio на верхнем уровне тела запроса. metadata.generate_audio_switch не включает звук и не активирует тариф со звуком.integer
Случайное зерно в диапазоне от
0 до 2147483647.Пример генерации по изображению
{
"model": "pixverse-v6-max",
"prompt": "Make the subject walk forward slowly",
"image_urls": ["https://example.com/start.png"],
"duration": 5,
"resolution": "1080p"
}
Запрос состояния задачи
Замените ID задачи в следующем запросе наtask_id, полученный при отправке:
curl --request GET \
--url 'https://api.apimart.ai/v1/videos/generations/<task_id>' \
--header 'Authorization: Bearer <token>'
Оплата
Стоимость равна длительности результата в секундах, умноженной на цену за секунду для выбранных разрешения и настройки звука. Для генерации со звуком и без него действуют отдельные тарифы; со звуком цена за секунду выше. Если не заданы ниresolution, ни quality, для результата и оплаты используется 540p.
Актуальные цены возвращает эндпоинт цен модели:
| Настройка звука | Поле цены |
|---|---|
| Без звука | Цена соответствующего разрешения в resolution_paid_prices |
| Со звуком | Соответствующий уровень <resolution>-audio в billing_tier_paid_prices |
Неподдерживаемые функции и ошибки параметров
Следующие запросы синхронно возвращают HTTP 400, без создания задачи и списания средств:| Запрос | Сообщение об ошибке |
|---|---|
Содержит extend_from_task_id | pixverse-v6-max does not support video extend …; use pixverse-v6 instead |
Содержит img_references | pixverse-v6-max does not support multi-image reference … |
Содержит first_frame_image или last_frame_image | pixverse-v6-max does not support first/last frame transition … |
В image_urls передано 2 изображения или более | pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N) |
resolution не входит в 4 поддерживаемых уровня | invalid resolution … |
duration превышает 15 секунд | invalid duration … |
При генерации по тексту aspect_ratio не входит в 8 поддерживаемых соотношений | invalid aspect_ratio … |