動画生成タスクを送信
OpenRouter 形式のフラットな動画入力です。Felo のモデル ID、チャンネル、タスク ID、レスポンスの形式は変わりません。旧来の input ラッパーとプロバイダー固有のフィールドは拒否されます。コールバック、続きの生成、プロバイダーオプション、動画のアップスケールには対応していません。モデルやチャンネルの機能によって、これらのパラメータがさらに制限される場合があります。HTTP 202 と Felo の task_id を返します。GET /api/v1/videos/generations/{task_id} をポーリングしてください。サポートされていないフィールドは HTTP 400 を返します。
- 型: stringX
- Request - Id 任意の呼び出し元リクエスト ID。診断用にそのまま返されます。
- 型: stringX
- Felo - Channel カンマ区切りの公開チャンネルコード(順序どおり)。このヘッダーを省略すると default が使われ、default は単独でのみ使用できます。ウォレットモードでは、default はモデルの有効な公開チャンネル順を逆から走査し、未公開または利用不可のチャンネルをスキップして、最初に利用可能なチャンネルのプロバイダーを選択します。そのプロバイダーから、同じ上流モデル ID とサービスティアを持つ利用可能なエンドポイントを含めます。明示的なチャンネルはクライアントが指定した順序で検証され、最初のチャンネルのプロバイダーグループのみが送信されます。他のプロバイダーへの自動フォールバックはありません。従来のプロバイダーヘッダーでチャンネルルーティングを上書きすることはできません。
OpenRouter 形式のフラットな動画入力です。Felo のモデル ID、チャンネル、タスク ID、レスポンスの形式は変わりません。旧来の 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
- 型: objectprovider
- options型: object必須
Options keyed by the slug published in the model catalog provider_options.
- property型: object
Name
- 型: 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
Felo APIキーが無効または未指定です
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"
]
}