Надіслати завдання на генерацію відео
Плоский вхід для відео у стилі OpenRouter. Ідентифікатори моделей Felo, канали, ідентифікатори завдань і формат відповідей не змінюються. Застарілі обгортки input і власні поля провайдерів відхиляються. Зворотні виклики, продовження генерації, параметри провайдера й апскейлінг відео не підтримуються. Можливості моделі чи каналу можуть додатково обмежувати ці параметри. Повертає HTTP 202 із task_id Felo. Опитуйте GET /api/v1/videos/generations/{task_id}. Непідтримувані поля повертають HTTP 400.
- Тип: stringX
- Request - Id Необов'язковий ID запиту від клієнта, який повертається у відповіді для діагностики.
- Тип: stringX
- Felo - Channel Упорядкований список публічних кодів каналів, розділених комами. Щоб використовувати стандартний канал, не передавайте цей заголовок; значення default потрібно вказувати окремо. У режимі гаманця default переглядає ефективний порядок публічних каналів моделі у зворотному напрямку, пропускає неопубліковані або недоступні канали та обирає постачальника першого доступного каналу. Він охоплює доступні ендпоінти цього постачальника з тим самим ID моделі в апстрімі та рівнем обслуговування. Явно вказані канали перевіряються в порядку, заданому клієнтом; надсилається лише група постачальника першого каналу. Автоматичного переходу до інших постачальників немає. Застарілі заголовки постачальника не можуть перевизначити маршрутизацію каналів.
Плоский вхід для відео у стилі OpenRouter. Ідентифікатори моделей Felo, канали, ідентифікатори завдань і формат відповідей не змінюються. Застарілі обгортки input і власні поля провайдерів відхиляються. Зворотні виклики, продовження генерації, параметри провайдера й апскейлінг відео не підтримуються. Можливості моделі чи каналу можуть додатково обмежувати ці параметри.
- Тип: stringmodelмінімальна довжина:1обов'язкове
- Тип: string перелікaspect
_ratio значення- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 3:2
- 2:3
- 21:9
- 9:21
- Тип: string перелікcharacter
_orientation Required by supported Kling motion-control models: orientation source.
значення- image
- video
- Тип: integerdurationмін.:1
Integer numbers.
- Тип: array object[]frame
_images - frameТип: string перелік
_type обов'язковезначення- first
_frame - last
_frame
- image
_url обов'язкове- urlТип: stringмінімальна довжина:1обов'язкове
- Тип: string
- fileТип: string
_id максимальна довжина:80Uploaded Felo file owned by the authenticated user.
- typeперелікконстанта:image_urlобов'язковезначення
- image
_url
- Тип: booleangenerate
_audio - Тип: arrayinput
_references - image
_url обов'язкове- urlТип: stringмінімальна довжина:1обов'язкове
- Тип: string
- fileТип: string
_id максимальна довжина:80Uploaded Felo file owned by the authenticated user.
- typeперелікконстанта:image_urlобов'язковезначення
- image
_url
- Тип: stringprompt
- Тип: string перелікresolutionзначення
- 360p
- 480p
- 720p
- 768p
- 1080p
- 1
K - 2
K - 4
K
- Тип: integerseed
Integer numbers.
- Тип: stringsession
_id максимальна довжина:256 - Тип: stringsize
- Тип: objecttrace
- generationТип: string
_name - parentТип: string
_span _id - spanТип: string
_name - traceТип: string
_id - traceТип: string
_name - propertyТип: anything
Name
- Тип: stringuserмаксимальна довжина:256
- Тип: object · VideoGenerationAccepted202
Завдання прийнято
- перелікkindконстанта:videoобов'язковезначення
- video
- Тип: array string[]outputsобов'язкове
Порожній, доки завдання не завершиться успішно.
- перелікstatusконстанта:queuedобов'язковезначення
- queued
- Тип: stringtask
_id обов'язковеID завдання для опитування статусу.
application/json - Тип: object · GenerationError400
Некоректний запит (невідома модель, змішані режими введення, неприпустимі поля)
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json - Тип: object · GenerationError401
Недійсний або відсутній API-ключ Felo
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json - Тип: object · GenerationError402
Недостатній баланс / умови білінгу не виконано
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json - Тип: object · GenerationError403
Обліковий запис не має дозволу (потрібна підписка або користувача заблоковано). Вимкнені моделі також відхиляються до викликів до апстріму. Уже прийняті запити та завдання продовжують виконуватися.
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json - Тип: object · GenerationError429
Досягнуто ліміту запитів або витрат
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json - Тип: object · GenerationError502
Помилка постачальника в апстрімі
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json - Тип: object · GenerationError503
Служба генерації або служба білінгу тимчасово недоступна
Конверт помилки, сумісний з OpenAI.
- Тип: objecterror
- messageТип: stringобов'язкове
- typeТип: string перелікобов'язковезначення
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string допускає null
application/json
curl https://openapi.felo.ai/api/v1/videos/generations \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "veo-3.1-lite",
"prompt": "A cinematic camera move",
"duration": 4,
"resolution": "720p",
"generate_audio": false,
"frame_images": [
{
"type": "image_url",
"frame_type": "first_frame",
"image_url": {
"url": "https://example.com/first.png"
}
}
]
}'
{
"task_id": "string",
"status": "queued",
"kind": "video",
"outputs": [
"string"
]
}