Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

動画生成タスクを送信

サーバー:https://openapi.felo.ai
クライアントライブラリ

動画生成タスクを送信

​

OpenRouter 形式のフラットな動画入力です。Felo のモデル ID、チャンネル、タスク ID、レスポンスの形式は変わりません。旧来の input ラッパーとプロバイダー固有のフィールドは拒否されます。コールバック、続きの生成、プロバイダーオプション、動画のアップスケールには対応していません。モデルやチャンネルの機能によって、これらのパラメータがさらに制限される場合があります。HTTP 202 と Felo の task_id を返します。GET /api/v1/videos/generations/{task_id} をポーリングしてください。サポートされていないフィールドは HTTP 400 を返します。

ヘッダー
  • X-Request-Id
    型: string

    任意の呼び出し元リクエスト ID。診断用にそのまま返されます。

  • X-Felo-Channel
    型: string

    カンマ区切りの公開チャンネルコード(順序どおり)。このヘッダーを省略すると default が使われ、default は単独でのみ使用できます。ウォレットモードでは、default はモデルの有効な公開チャンネル順を逆から走査し、未公開または利用不可のチャンネルをスキップして、最初に利用可能なチャンネルのプロバイダーを選択します。そのプロバイダーから、同じ上流モデル ID とサービスティアを持つ利用可能なエンドポイントを含めます。明示的なチャンネルはクライアントが指定した順序で検証され、最初のチャンネルのプロバイダーグループのみが送信されます。他のプロバイダーへの自動フォールバックはありません。従来のプロバイダーヘッダーでチャンネルルーティングを上書きすることはできません。

リクエストボディ·VideoGenerationRequest
必須
application/json

OpenRouter 形式のフラットな動画入力です。Felo のモデル ID、チャンネル、タスク ID、レスポンスの形式は変わりません。旧来の 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
  • provider
    型: object
    • options
      型: object
      必須

      Options keyed by the slug published in the model catalog provider_options.

      • propertyName
        型: object
  • 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

    Felo APIキーが無効または未指定です

    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

ヘルプが必要ですか?

  • API・請求・アカウントのご質問はサポートへ。
  • Discord で Felo の開発者と交流できます。
  • 更新履歴 をご覧ください。
  • ボリューム価格や購買についてのご相談は営業窓口へ。
  • LLM での構築をお考えですか?llms.txt をご覧ください。