curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
import requests
url = "https://api.apimart.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";
const payload = {
model: "gemini-omni-1.1-flash",
prompt: "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
aspect_ratio: "16:9",
resolution: "1080p"
};
const headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.apimart.ai/v1/videos/generations"
payload := map[string]interface{}{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
}
]
}
{
"error": {
"code": 400,
"message": "Недопустимые параметры запроса",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Ошибка аутентификации. Проверьте API-ключ",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Недостаточно средств. Пополните баланс и повторите попытку",
"type": "payment_required"
}
}
{
"error": {
"code": 429,
"message": "Слишком много запросов. Повторите попытку позже",
"type": "rate_limit_error"
}
}
Gemini Omni 1.1 Flash
Генерация видео Gemini Omni 1.1 Flash
- Официальная универсальная мультимодальная модель генерации видео Google Gemini Omni 1.1 Flash
- Поддерживает генерацию видео из текста и изображений, референсы нескольких объектов, интерполяцию первого и последнего кадров, редактирование и продолжение видео
- Поддерживает 360p / 720p / 1080p / 4K, 24 кадр/с, видео длительностью 3–10 секунд с генерируемым звуком
- Асинхронный API задач: после отправки результат доступен по ID задачи
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": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
import requests
url = "https://api.apimart.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";
const payload = {
model: "gemini-omni-1.1-flash",
prompt: "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
aspect_ratio: "16:9",
resolution: "1080p"
};
const headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.apimart.ai/v1/videos/generations"
payload := map[string]interface{}{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
}
]
}
{
"error": {
"code": 400,
"message": "Недопустимые параметры запроса",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Ошибка аутентификации. Проверьте API-ключ",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Недостаточно средств. Пополните баланс и повторите попытку",
"type": "payment_required"
}
}
{
"error": {
"code": 429,
"message": "Слишком много запросов. Повторите попытку позже",
"type": "rate_limit_error"
}
}
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
import requests
url = "https://api.apimart.ai/v1/videos/generations"
payload = {
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";
const payload = {
model: "gemini-omni-1.1-flash",
prompt: "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
aspect_ratio: "16:9",
resolution: "1080p"
};
const headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://api.apimart.ai/v1/videos/generations"
payload := map[string]interface{}{
"model": "gemini-omni-1.1-flash",
"prompt": "A marble rolling fast on a chain reaction style track, continuous smooth shot.",
"aspect_ratio": "16:9",
"resolution": "1080p",
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
}
]
}
{
"error": {
"code": 400,
"message": "Недопустимые параметры запроса",
"type": "invalid_request_error"
}
}
{
"error": {
"code": 401,
"message": "Ошибка аутентификации. Проверьте API-ключ",
"type": "authentication_error"
}
}
{
"error": {
"code": 402,
"message": "Недостаточно средств. Пополните баланс и повторите попытку",
"type": "payment_required"
}
}
{
"error": {
"code": 429,
"message": "Слишком много запросов. Повторите попытку позже",
"type": "rate_limit_error"
}
}
Аутентификация
string
обязательно
Для всех API требуется аутентификация с помощью Bearer Token.Получение API-ключа:Получите API-ключ на странице управления API-ключами.Добавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY
Параметры запроса
string
обязательно
Название модели генерации видео. Допустимо только
gemini-omni-1.1-flash.string
Текстовая инструкция. Для генерации из текста опишите сцену; для генерации из изображения, редактирования или продолжения видео опишите движение, стиль или нужное изменение.
Укажите хотя бы одно:
prompt или медиаматериалы (image_urls, изображения первого/последнего кадров либо video_urls).string
по умолчанию:"720p"
Разрешение выходного видео. Регистр не учитывается.Допустимые значения:
360p720p(по умолчанию)1080p4k
2160p обрабатывается как 4k. Разрешение определяет уровень предварительного списания и основную стоимость вывода видео.Неподдерживаемое разрешение приводит к ошибке
invalid_resolution.string
по умолчанию:"16:9"
Соотношение сторон видео для альбомной или портретной ориентации.Поддерживается:
16:9— альбомная ориентация (по умолчанию)9:16— портретная ориентация
16:9.При передаче
video_urls выход обычно сохраняет соотношение сторон исходного видео, поэтому aspect_ratio может не применяться.array<string>
Массив референсных изображений. Поддерживаются только общедоступные HTTP/HTTPS URL.
- 1 изображение: по умолчанию используется как начальный кадр видео
- Несколько изображений: используются как референсы объектов или стиля; опишите назначение и взаимосвязь изображений в
prompt
В
image_urls и изображениях первого/последнего кадров суммарно допускается не более 10 изображений.string
Изображение первого кадра. Поддерживается только общедоступный HTTP/HTTPS URL.
- Передано отдельно: изображение используется как начальный кадр видео
- Передано вместе с
last_frame_image: создается видео с плавным переходом от первого кадра к последнему
string
Изображение последнего кадра. Поддерживается только общедоступный HTTP/HTTPS URL; его необходимо передавать вместе с
first_frame_image.Если передать только
last_frame_image, вернется ошибка invalid_frame_images. Рекомендуется использовать одинаковое соотношение сторон для обоих кадров и согласовать его с aspect_ratio.Для первого кадра или пары первого и последнего кадров следующие способы равнозначны. Выберите один и не передавайте оба одновременно:
- Используйте
first_frame_image/last_frame_image - Используйте
image_with_rolesи задайтеroleкакfirst_frame/last_frame
array<object>
Массив изображений с ролями. Это эквивалентная альтернатива
Пример:
first_frame_image / last_frame_image, которая также позволяет задавать референсные изображения.Показать Элемент image_with_roles
Показать Элемент image_with_roles
[
{"url": "https://example.com/start.jpg", "role": "first_frame"},
{"url": "https://example.com/end.jpg", "role": "last_frame"}
]
Если также передан
image_urls, референсы берутся из image_urls и не объединяются с референсами в image_with_roles. Общее число фактически используемых изображений, включая первый и последний кадры, не должно превышать 10.array<string>
Массив видео для редактирования или продолжения. Сейчас допускается не более одного видео длительностью до 10 секунд.Поддерживаются только общедоступные прямые HTTP/HTTPS ссылки на видео. Ссылки YouTube не поддерживаются.
video_urls и extend_from_task_id взаимоисключающие. Укажите только одно из них.object
Объект дополнительных параметров для явного указания цели генерации.
Показать Поля metadata
Показать Поля metadata
string
Допустимые типы задачи:
text_to_video: генерация видео из текстаimage_to_video: генерация видео из изображенияreference_to_video: генерация видео по референсамedit: редактирование видеоextend: продолжение видео
При интерполяции первого и последнего кадров модель определяет тип задачи автоматически, а платформа не передает
metadata.task.string
Локальный
task_id предыдущей задачи генерации. Используется для диалогового редактирования или дальнейшего продолжения без повторной загрузки предыдущего видео.Указанная задача должна принадлежать текущему пользователю, быть успешно завершена и относиться к модели Gemini Omni.extend_from_task_id и video_urls взаимоисключающие. Укажите только одно из них.У модели нет параметра
duration. Длительность каждого результата определяется моделью автоматически и обычно составляет 3–10 секунд. Для управления темпом опишите его в prompt естественным языком или временными интервалами.Ответ
integer
Код ответа. При успехе —
200.array
Получение результата задачи
Генерация видео выполняется асинхронно. После полученияtask_id используйте API получения статуса задачи, чтобы запросить прогресс и результат.
cURL
curl --request GET \
--url https://api.apimart.ai/v1/tasks/task_01KS1H7ZYSJWH1N779S2FSHTKA \
--header 'Authorization: Bearer <token>'
completed или failed. Рекомендуемый общий тайм-аут клиента — 10 минут.
Пример успешного результата
{
"code": 200,
"data": {
"id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
"status": "completed",
"progress": 100,
"cost": 1.52,
"credits_cost": 15.2,
"result": {
"videos": [
{
"url": ["https://cdn.example.com/gemini_omni_xxx.mp4"],
"expires_at": 1788518400
}
]
}
}
}
Примеры использования
Пример 1: генерация видео из текста (4K)
{
"model": "gemini-omni-1.1-flash",
"prompt": "a blue butterfly landing on a flower, macro, soft light, no dialogue",
"aspect_ratio": "9:16",
"resolution": "4k"
}
Пример 2: интерполяция первого и последнего кадров
{
"model": "gemini-omni-1.1-flash",
"prompt": "smooth transition, camera slowly pushes in",
"first_frame_image": "https://example.com/start.jpg",
"last_frame_image": "https://example.com/end.jpg",
"resolution": "720p"
}
Пример 3: референсы нескольких объектов
{
"model": "gemini-omni-1.1-flash",
"prompt": "the cat playfully bats at the ball of yarn",
"image_urls": [
"https://example.com/cat.png",
"https://example.com/yarn.png"
],
"resolution": "720p"
}
Пример 4: первый и последний кадры через роли изображений
{
"model": "gemini-omni-1.1-flash",
"prompt": "a smooth cinematic transition from sunrise to a starry night",
"image_with_roles": [
{"url": "https://example.com/sunrise.jpg", "role": "first_frame"},
{"url": "https://example.com/night.jpg", "role": "last_frame"}
],
"resolution": "1080p"
}
Пример 5: редактирование видео
{
"model": "gemini-omni-1.1-flash",
"prompt": "Make the violin invisible. Keep everything else the same.",
"video_urls": ["https://example.com/clip.mp4"]
}
Keep everything else the same, чтобы сохранить остальное без изменений.
Пример 6: диалоговое продолжение
{
"model": "gemini-omni-1.1-flash",
"prompt": "Extend this video: the camera pans across the mountains.",
"extend_from_task_id": "task_01AAA"
}