Отправка задачи генерации видео
Плоский ввод для видео в стиле 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 должен использоваться только сам по себе. В режиме wallet значение по умолчанию просматривает эффективный публичный порядок каналов модели в обратном направлении, пропускает неопубликованные и недоступные каналы и выбирает провайдера первого доступного канала. Оно включает доступные эндпоинты этого провайдера с тем же upstream ID модели и уровнем обслуживания. Явные каналы проверяются в порядке, указанном клиентом; отправляется только группа провайдера первого канала. Автоматического переключения на других провайдеров нет. Устаревшие заголовки провайдеров не могут переопределить маршрутизацию по каналам.
Плоский ввод для видео в стиле OpenRouter. Идентификаторы моделей Felo, каналы, идентификаторы задач и формат ответов не меняются. Устаревшие обёртки input и собственные поля провайдеров отклоняются. Обратные вызовы, продолжение генерации, параметры провайдера и апскейлинг видео не поддерживаются. Возможности модели и канала могут дополнительно ограничивать эти параметры.
- Тип: stringmodelмин. длина:1обязательно
- Тип: string enumaspect
_ratio значения- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 3:2
- 2:3
- 21:9
- 9:21
- Тип: string enumcharacter
_orientation Required by supported Kling motion-control models: orientation source.
значения- image
- video
- Тип: integerdurationмин.:1
Integer numbers.
- Тип: array object[]frame
_images - frameТип: string enum
_type обязательнозначения- first
_frame - last
_frame
- image
_url обязательно- urlТип: stringмин. длина:1обязательно
- Тип: string
- fileТип: string
_id макс. длина:80Uploaded Felo file owned by the authenticated user.
- typeenumконстанта: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.
- typeenumконстанта:image_urlобязательнозначения
- image
_url
- Тип: stringprompt
- Тип: objectprovider
- optionsТип: objectобязательно
Options keyed by the slug published in the model catalog provider_options.
- propertyТип: object
Name
- Тип: string enumresolutionзначения
- 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
Задача принята
- enumkindконстанта:videoобязательнозначения
- video
- Тип: array string[]outputsобязательно
Пусто до успешного завершения задачи.
- enumstatusконстанта:queuedобязательнозначения
- queued
- Тип: stringtask
_id обязательноID задачи для опроса.
application/json - Тип: object · GenerationError400
Некорректный запрос (неизвестная модель, смешение режимов ввода, недопустимые поля)
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string может быть null
application/json - Тип: object · GenerationError401
Недействительный или отсутствующий API-ключ Felo
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string может быть null
application/json - Тип: object · GenerationError402
Недостаточно средств на балансе / не выполнено требование биллинга
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string может быть null
application/json - Тип: object · GenerationError403
Аккаунт не имеет доступа (требуется подписка или пользователь заблокирован). Отключённые модели также отклоняются до вызова upstream. Уже принятые запросы и задачи продолжают выполняться.
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string может быть null
application/json - Тип: object · GenerationError429
Достигнут лимит запросов или расходов
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string может быть null
application/json - Тип: object · GenerationError502
Сбой upstream-провайдера
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- invalid
_request _error - server
_error
- codeТип: string
- paramТип: string может быть null
application/json - Тип: object · GenerationError503
Сервис генерации или сервис биллинга временно недоступен
Конверт ошибок, совместимый с OpenAI.
- Тип: objecterror
- messageТип: stringобязательно
- typeТип: string enumобязательнозначения
- 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"
]
}