Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Надіслати завдання на генерацію відео

Сервер:https://openapi.felo.ai
Клієнтські бібліотеки

Надіслати завдання на генерацію відео

​

Плоский вхід для відео у стилі OpenRouter. Ідентифікатори моделей Felo, канали, ідентифікатори завдань і формат відповідей не змінюються. Застарілі обгортки input і власні поля провайдерів відхиляються. Зворотні виклики, продовження генерації, параметри провайдера й апскейлінг відео не підтримуються. Можливості моделі чи каналу можуть додатково обмежувати ці параметри. Повертає HTTP 202 із task_id Felo. Опитуйте GET /api/v1/videos/generations/{task_id}. Непідтримувані поля повертають HTTP 400.

Заголовки
  • X-Request-Id
    Тип: string

    Необов'язковий ID запиту від клієнта, який повертається у відповіді для діагностики.

  • X-Felo-Channel
    Тип: string

    Упорядкований список публічних кодів каналів, розділених комами. Щоб використовувати стандартний канал, не передавайте цей заголовок; значення default потрібно вказувати окремо. У режимі гаманця default переглядає ефективний порядок публічних каналів моделі у зворотному напрямку, пропускає неопубліковані або недоступні канали та обирає постачальника першого доступного каналу. Він охоплює доступні ендпоінти цього постачальника з тим самим ID моделі в апстрімі та рівнем обслуговування. Явно вказані канали перевіряються в порядку, заданому клієнтом; надсилається лише група постачальника першого каналу. Автоматичного переходу до інших постачальників немає. Застарілі заголовки постачальника не можуть перевизначити маршрутизацію каналів.

Тіло·VideoGenerationRequest
обов'язкове
application/json

Плоский вхід для відео у стилі OpenRouter. Ідентифікатори моделей Felo, канали, ідентифікатори завдань і формат відповідей не змінюються. Застарілі обгортки input і власні поля провайдерів відхиляються. Зворотні виклики, продовження генерації, параметри провайдера й апскейлінг відео не підтримуються. Можливості моделі чи каналу можуть додатково обмежувати ці параметри.

  • model
    Тип: string
    мінімальна довжина:  
    1
    обов'язкове
  • aspect_ratio
    Тип: string перелік
    значення
    • 16:9
    • 9:16
    • 1:1
    • 4:3
    • 3:4
    • 3:2
    • 2:3
    • 21:9
    • 9:21
  • character_orientation
    Тип: string перелік

    Required by supported Kling motion-control models: orientation source.

    значення
    • image
    • video
  • duration
    Тип: integer
    мін.:  
    1

    Integer numbers.

  • frame_images
    Тип: array object[]
    • frame_type
      Тип: string перелік
      обов'язкове
      значення
      • first_frame
      • last_frame
    • image_url
      обов'язкове
      • url
        Тип: string
        мінімальна довжина:  
        1
        обов'язкове
        • Тип: string
      • file_id
        Тип: string
        максимальна довжина:  
        80

        Uploaded Felo file owned by the authenticated user.

    • type
      перелік
      константа:  
      image_url
      обов'язкове
      значення
      • image_url
  • generate_audio
    Тип: boolean
  • input_references
    Тип: array
      • image_url
        обов'язкове
        • url
          Тип: string
          мінімальна довжина:  
          1
          обов'язкове
          • Тип: string
        • file_id
          Тип: string
          максимальна довжина:  
          80

          Uploaded Felo file owned by the authenticated user.

      • type
        перелік
        константа:  
        image_url
        обов'язкове
        значення
        • image_url
  • prompt
    Тип: string
  • resolution
    Тип: string перелік
    значення
    • 360p
    • 480p
    • 720p
    • 768p
    • 1080p
    • 1K
    • 2K
    • 4K
  • seed
    Тип: integer

    Integer numbers.

  • session_id
    Тип: string
    максимальна довжина:  
    256
  • size
    Тип: string
  • trace
    Тип: object
    • generation_name
      Тип: string
    • parent_span_id
      Тип: string
    • span_name
      Тип: string
    • trace_id
      Тип: string
    • trace_name
      Тип: string
    • propertyName
      Тип: anything
  • user
    Тип: string
    максимальна довжина:  
    256
Відповіді
  • 202
    Тип: object · VideoGenerationAccepted

    Завдання прийнято

    • kind
      перелік
      константа:  
      video
      обов'язкове
      значення
      • video
    • outputs
      Тип: array string[]
      обов'язкове

      Порожній, доки завдання не завершиться успішно.

    • status
      перелік
      константа:  
      queued
      обов'язкове
      значення
      • queued
    • task_id
      Тип: string
      обов'язкове

      ID завдання для опитування статусу.

    application/json
  • 400
    Тип: object · GenerationError

    Некоректний запит (невідома модель, змішані режими введення, неприпустимі поля)

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
  • 401
    Тип: object · GenerationError

    Недійсний або відсутній API-ключ Felo

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
  • 402
    Тип: object · GenerationError

    Недостатній баланс / умови білінгу не виконано

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
  • 403
    Тип: object · GenerationError

    Обліковий запис не має дозволу (потрібна підписка або користувача заблоковано). Вимкнені моделі також відхиляються до викликів до апстріму. Уже прийняті запити та завдання продовжують виконуватися.

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
  • 429
    Тип: object · GenerationError

    Досягнуто ліміту запитів або витрат

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
  • 502
    Тип: object · GenerationError

    Помилка постачальника в апстрімі

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
  • 503
    Тип: object · GenerationError

    Служба генерації або служба білінгу тимчасово недоступна

    Конверт помилки, сумісний з OpenAI.

    • error
      Тип: object
      • message
        Тип: string
        обов'язкове
      • type
        Тип: string перелік
        обов'язкове
        значення
        • invalid_request_error
        • server_error
      • code
        Тип: string
      • param
        Тип: string допускає null
    application/json
Request Example for post/api/v1/videos/generations
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"
  ]
}
Submit a video generation task

Потрібна допомога?