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

Доступные модели

Полный список моделей можно посмотреть на странице Модели или получить динамически через API эндпоинт: https://openai.bothub.chat/v1/videos/models

BotHub предоставляет выделенный API для генерации видео, работающий по асинхронному паттерну. Генерация видео — это долгая операция: запрос возвращается мгновенно со статусом pending, а результат нужно получить отдельным запросом по ID видео.

---

Как это работает

1. Отправьте запрос на генерацию — POST /v1/videos/generations возвращает сразу с status: "pending" и идентификатором id.
2. Опрашивайте статус — Периодически вызывайте GET /v1/videos/:videoId до тех пор, пока status не станет "completed" или "failed".
3. Скачайте видео — После завершения поле unsigned_urls содержит ссылки на готовое видео.

---

Эндпоинты

POST /v1/videos/generations

Создаёт новый запрос на генерацию видео. Возвращается мгновенно — генерация происходит асинхронно.

Базовый URL: https://openai.bothub.chat

Аутентификация: Authorization: Bearer ВАШ_API_КЛЮЧ_BOTHUB

Тело запроса

Поле	Тип	Описание
model	string	ID модели (например, veo-3.1, kling-v2.6)
prompt	string	Текстовое описание видео
imageUrl	string	URL входного изображения для режима image-to-video (опционально)
notify	boolean	Отправить email-уведомление по завершении (опционально)
settings	object	Параметры генерации (см. ниже)

Объект settings

Поле	Тип	Описание
duration_seconds	number	Длительность видео: 4, 5, 6, 7, 8, 9, 10 или 12
aspect_ratio	string	Например: "16:9", "9:16", "1:1"
negative_prompt	string	Что избегать при генерации
generate_audio	boolean	Генерировать ли звук
seed	number	Seed для воспроизводимых результатов

Параметры, специфичные для модели

Каждая модель поддерживает разный набор настроек. Уточняйте полный список параметров на странице модели в Каталоге моделей.

---

GET /v1/videos/{videoId}

Возвращает текущий статус и результат запроса на генерацию видео.

Query-параметр	Описание
include_usage	Передайте "true", чтобы получить информацию о потраченных капсах

---

GET /v1/videos/models

Возвращает список доступных моделей для генерации видео.

---

Генерация видео по тексту

JS

async function generateVideo() {
  const BASE_URL = 'https://openai.bothub.chat/v1';
  const API_KEY = 'ВАШ_API_КЛЮЧ_BOTHUB';

  // Шаг 1: Создаём запрос на генерацию
  const createRes = await fetch(`${BASE_URL}/videos/generations`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${API_KEY}`,
    },
    body: JSON.stringify({
      model: 'veo-3.1',
      prompt: 'Таймлапс цветущего цветка в солнечном саду',
      notify: false,
      settings: {
        duration_seconds: 6,
        aspect_ratio: '16:9',
      },
    }),
  });

  const { id } = await createRes.json();
  console.log('Запрос создан, id:', id);

  // Шаг 2: Опрашиваем статус до завершения
  let video;
  while (true) {
    await new Promise((r) => setTimeout(r, 10000));
    const statusRes = await fetch(`${BASE_URL}/videos/${id}?include_usage=true`, {
      headers: { Authorization: `Bearer ${API_KEY}` },
    });
    video = await statusRes.json();
    console.log('Статус:', video.status);
    if (video.status === 'completed' || video.status === 'failed') break;
  }

  if (video.status === 'completed') {
    console.log('URL видео:', video.unsignedUrls[0]);
  } else {
    console.error('Ошибка генерации:', video.error);
  }
}

generateVideo();

Python

import time
import requests

BASE_URL = 'https://openai.bothub.chat/v1'
API_KEY = 'ВАШ_API_КЛЮЧ_BOTHUB'
headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {API_KEY}',
}

# Шаг 1: Создаём запрос на генерацию
response = requests.post(
    f'{BASE_URL}/videos/generations',
    json={
        'model': 'veo-3.1',
        'prompt': 'Таймлапс цветущего цветка в солнечном саду',
        'notify': False,
        'settings': {
            'duration_seconds': 6,
            'aspect_ratio': '16:9',
        },
    },
    headers=headers,
)
video_id = response.json()['id']
print('Запрос создан, id:', video_id)

# Шаг 2: Опрашиваем статус
while True:
    time.sleep(10)
    status_res = requests.get(
        f'{BASE_URL}/videos/{video_id}?include_usage=true',
        headers=headers,
    )
    video = status_res.json()
    print('Статус:', video['status'])
    if video['status'] in ('completed', 'failed'):
        break

if video['status'] == 'completed':
    print('URL видео:', video['unsigned_urls'][0])
else:
    print('Ошибка генерации:', video.get('error'))

Go

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"time"
)

const (
	baseURL = "https://openai.bothub.chat/v1"
	apiKey  = "ВАШ_API_КЛЮЧ_BOTHUB"
)

func do(method, url string, body any) map[string]any {
	var r io.Reader
	if body != nil {
		b, _ := json.Marshal(body)
		r = bytes.NewReader(b)
	}
	req, _ := http.NewRequest(method, url, r)
	req.Header.Set("Authorization", "Bearer "+apiKey)
	if body != nil {
		req.Header.Set("Content-Type", "application/json")
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	raw, _ := io.ReadAll(resp.Body)
	if resp.StatusCode >= 300 {
		panic(fmt.Sprintf("%s\n%s", resp.Status, raw))
	}
	var out map[string]any
	if err := json.Unmarshal(raw, &out); err != nil {
		panic(err)
	}
	return out
}

func main() {
	created := do("POST", baseURL+"/videos/generations", map[string]any{
		"model":  "veo-3.1",
		"prompt": "Таймлапс цветущего цветка в солнечном саду",
		"notify": false,
		"settings": map[string]any{
			"duration_seconds": 6,
			"aspect_ratio":     "16:9",
		},
	})
	id := created["id"].(string)
	fmt.Println("Запрос создан, id:", id)

	for {
		time.Sleep(10 * time.Second)
		video := do("GET", baseURL+"/videos/"+id+"?include_usage=true", nil)
		status := video["status"].(string)
		fmt.Println("Статус:", status)
		if status == "completed" {
			fmt.Println("URL видео:", video["unsigned_urls"].([]any)[0])
			return
		}
		if status == "failed" {
			panic(video["error"])
		}
	}
}

cURL

# Шаг 1: Создаём запрос на генерацию
curl https://openai.bothub.chat/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ_BOTHUB" \
  -d '{
    "model": "veo-3.1",
    "prompt": "Таймлапс цветущего цветка в солнечном саду",
    "notify": false,
    "settings": {
      "duration_seconds": 6,
      "aspect_ratio": "16:9"
    }
  }'

# Шаг 2: Проверяем статус (замените VIDEO_ID на id из шага 1)
curl "https://openai.bothub.chat/v1/videos/VIDEO_ID?include_usage=true" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ_BOTHUB"

Ответ — Шаг 1 (создание):

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "modelId": "veo-3.1",
  "providerId": "replicate",
  "status": "pending",
  "createdAt": "2025-01-15T10:30:00Z",
  "userId": "user-id",
  "error": null,
  "payment": false,
  "notify": false,
  "unsigned_urls": []
}

Ответ — Шаг 2 (завершено):

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "modelId": "veo-3.1",
  "providerId": "replicate",
  "status": "completed",
  "createdAt": "2025-01-15T10:30:00Z",
  "userId": "user-id",
  "error": null,
  "payment": true,
  "notify": false,
  "unsigned_urls": [
    "https://storage.bothub.chat/videos/a1b2c3d4-e5f6-7890-abcd-ef1234567890.mp4"
  ],
  "outputFileId": "file-uuid",
  "usage": {
    "caps": 250
  }
}

---

Генерация видео по изображению

Передайте imageUrl, чтобы оживить статичное изображение. Модель использует его как первый кадр видео.

JS

async function imageToVideo() {
  const BASE_URL = 'https://openai.bothub.chat/v1';
  const API_KEY = 'ВАШ_API_КЛЮЧ_BOTHUB';

  const createRes = await fetch(`${BASE_URL}/videos/generations`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${API_KEY}`,
    },
    body: JSON.stringify({
      model: 'kling-v2.6',
      prompt: 'Человек медленно оборачивается и улыбается в камеру',
      imageUrl: 'https://example.com/portrait.jpg',
      notify: false,
      settings: {
        duration_seconds: 5,
        aspect_ratio: '9:16',
        negative_prompt: 'размытость, низкое качество',
      },
    }),
  });

  const { id } = await createRes.json();

  let video;
  while (true) {
    await new Promise((r) => setTimeout(r, 10000));
    const res = await fetch(`${BASE_URL}/videos/${id}`, {
      headers: { Authorization: `Bearer ${API_KEY}` },
    });
    video = await res.json();
    if (video.status === 'completed' || video.status === 'failed') break;
  }

  console.log(video.status === 'completed' ? video.unsignedUrls[0] : video.error);
}

imageToVideo();

Python

import time
import requests

BASE_URL = 'https://openai.bothub.chat/v1'
API_KEY = 'ВАШ_API_КЛЮЧ_BOTHUB'
headers = {
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {API_KEY}',
}

response = requests.post(
    f'{BASE_URL}/videos/generations',
    json={
        'model': 'kling-v2.6',
        'prompt': 'Человек медленно оборачивается и улыбается в камеру',
        'imageUrl': 'https://example.com/portrait.jpg',
        'notify': False,
        'settings': {
            'duration_seconds': 5,
            'aspect_ratio': '9:16',
            'negative_prompt': 'размытость, низкое качество',
        },
    },
    headers=headers,
)
video_id = response.json()['id']

while True:
    time.sleep(10)
    video = requests.get(f'{BASE_URL}/videos/{video_id}', headers=headers).json()
    if video['status'] in ('completed', 'failed'):
        break

print(video['unsigned_urls'][0] if video['status'] == 'completed' else video.get('error'))

Go

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"time"
)

const (
	baseURL = "https://openai.bothub.chat/v1"
	apiKey  = "ВАШ_API_КЛЮЧ_BOTHUB"
)

func do(method, url string, body any) map[string]any {
	var r io.Reader
	if body != nil {
		b, _ := json.Marshal(body)
		r = bytes.NewReader(b)
	}
	req, _ := http.NewRequest(method, url, r)
	req.Header.Set("Authorization", "Bearer "+apiKey)
	if body != nil {
		req.Header.Set("Content-Type", "application/json")
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	raw, _ := io.ReadAll(resp.Body)
	if resp.StatusCode >= 300 {
		panic(fmt.Sprintf("%s\n%s", resp.Status, raw))
	}
	var out map[string]any
	if err := json.Unmarshal(raw, &out); err != nil {
		panic(err)
	}
	return out
}

func main() {
	created := do("POST", baseURL+"/videos/generations", map[string]any{
		"model":    "kling-v2.6",
		"prompt":   "Человек медленно оборачивается и улыбается в камеру",
		"imageUrl": "https://example.com/portrait.jpg",
		"notify":   false,
		"settings": map[string]any{
			"duration_seconds": 5,
			"aspect_ratio":     "9:16",
			"negative_prompt":  "размытость, низкое качество",
		},
	})
	id := created["id"].(string)

	for {
		time.Sleep(10 * time.Second)
		video := do("GET", baseURL+"/videos/"+id, nil)
		status := video["status"].(string)
		if status == "completed" {
			fmt.Println(video["unsigned_urls"].([]any)[0])
			return
		}
		if status == "failed" {
			fmt.Println(video["error"])
			return
		}
	}
}

cURL

curl https://openai.bothub.chat/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ_BOTHUB" \
  -d '{
    "model": "kling-v2.6",
    "prompt": "Человек медленно оборачивается и улыбается в камеру",
    "imageUrl": "https://example.com/portrait.jpg",
    "notify": false,
    "settings": {
      "duration_seconds": 5,
      "aspect_ratio": "9:16",
      "negative_prompt": "размытость, низкое качество"
    }
  }'

---

Список доступных моделей

JS

const res = await fetch('https://openai.bothub.chat/v1/videos/models', {
  headers: { Authorization: 'Bearer ВАШ_API_КЛЮЧ_BOTHUB' },
});
const { data } = await res.json();
console.log(data.map((m) => m.id));

Python

import requests

res = requests.get(
    'https://openai.bothub.chat/v1/videos/models',
    headers={'Authorization': 'Bearer ВАШ_API_КЛЮЧ_BOTHUB'},
)
models = res.json()['data']
print([m['id'] for m in models])

Go

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://openai.bothub.chat/v1/videos/models", nil)
	req.Header.Set("Authorization", "Bearer ВАШ_API_КЛЮЧ_BOTHUB")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	raw, _ := io.ReadAll(resp.Body)
	var result struct {
		Data []struct {
			ID string `json:"id"`
		} `json:"data"`
	}
	if err := json.Unmarshal(raw, &result); err != nil {
		panic(err)
	}
	for _, m := range result.Data {
		fmt.Println(m.ID)
	}
}

cURL

curl https://openai.bothub.chat/v1/videos/models \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ_BOTHUB"

Пример ответа:

{
  "object": "list",
  "data": [
    { "id": "veo-3.1",       "object": "model", "created": 1705334400, "owned_by": "replicate" },
    { "id": "kling-v2.6",  "object": "model", "created": 1705334400, "owned_by": "replicate" },
    { "id": "gen4_turbo",  "object": "model", "created": 1705334400, "owned_by": "runway" }
  ]
}

---

Статусы

Статус	Описание
pending	Генерация в процессе
completed	Видео готово — смотрите unsigned_urls
failed	Генерация завершилась с ошибкой — смотрите error

---

Рекомендации

• Интервал опроса: Запрашивайте статус каждые 10–15 секунд. Большинство моделей завершают генерацию за 1–3 минуты.
• Email-уведомления: Установите notify: true, чтобы получить письмо по завершении — удобно для долгих задач.
• Ограничения по длительности: Доступные значения зависят от модели. Если сомневаетесь, используйте 5 или 6 секунд.
• Image-to-video: imageUrl должен быть публично доступной ссылкой. Поддерживаемые форматы: JPEG, PNG, WebP.