v0.3.0

OpenAPI 3.1.0

Submit a video generation task

Felo API Support

MIT

サーバー

https://openapi.felo.ai

クライアントライブラリ

Shell Curl

Submit a video generation task

Creates an async video generation task and returns a task_id immediately (HTTP 202). Poll GET /api/v1/videos/generations/{task_id} until it succeeds. The request body can be provided either flattened ({model, prompt, ...}) or nested ({model, input: {prompt, ...}}); the input object takes precedence when present. callback fields (callBackUrl / callback_url / callbackUrl) are ignored.

Three mutually exclusive input modes:

text-to-video: prompt only;
image-to-video (first/last frame): first_frame_url (+ optional last_frame_url);
omni-reference: reference_image_urls / reference_video_urls / reference_audio_urls. Mixing first/last-frame with any multimodal reference input returns 400 invalid_request_error.

ヘッダー

X-Request-Id
型: string

Optional caller request ID echoed back for diagnostics.

リクエストボディ·VideoGenerationRequest

必須

application/json

Video generation input. Either flattened ({model, prompt, ...}) or nested ({model, input: {...}}). input takes precedence. Exactly one input mode must be used; mixing first/last-frame with multimodal reference inputs is rejected.

model
型: string
必須

Felo-facing model name, e.g. seedance-2.0-mini.
aspect_ratio
型: string 列挙値
値
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 21:9
- adaptive
duration
型: integer
最小値:
4
最大値:
15

Integer numbers.
first_frame_url
型: string 形式: uri
generate_audio
型: boolean
input
型: object

Optional nested input object; when present, its fields take precedence over sibling fields.
- aspect_ratio
  型: string 列挙値
  
  Output aspect ratio; adaptive follows the input image ratio.
  
  値
  16:9
  9:16
  1:1
  4:3
  3:4
  21:9
  adaptive
- duration
  型: integer
  最小値:
  4
  最大値:
  15
  
  Output duration in seconds.
- first_frame_url
  型: string 形式: uri
  
  First frame image URL (image-to-video mode).
- generate_audio
  型: boolean
  
  Whether to generate a synchronized audio track.
- last_frame_url
  型: string 形式: uri
  
  Last frame image URL; must be used together with first_frame_url.
- prompt
  型: string
  最大長:
  2000
  
  Prompt. Required for text-to-video and omni-reference modes.
- reference_audio_urls
  型: array string[] …3形式: uri
  
  Omni-reference audio clips.
- reference_image_urls
  型: array string[] …9形式: uri
  
  Omni-reference images. Mutually exclusive with first/last-frame.
- reference_video_urls
  型: array string[] …3形式: uri
  
  Omni-reference videos. Mutually exclusive with first/last-frame. Supplying video changes the billing unit price and adds input duration to the token count.
- resolution
  型: string 列挙値
  
  Output resolution. Higher resolution consumes more tokens and costs more.
  
  値
  480p
  720p
  1080p
  4k
last_frame_url
型: string 形式: uri
prompt
型: string
最大長:
2000
reference_audio_urls
型: array string[] …3形式: uri
reference_image_urls
型: array string[] …9形式: uri
reference_video_urls
型: array string[] …3形式: uri
resolution
型: string 列挙値
値
- 480p
- 720p
- 1080p
- 4k

レスポンス

202
型: object · VideoGenerationAccepted

Task accepted
kind
列挙値
定数:
video
必須
値
video
outputs
型: array string[]
必須

Empty until the task succeeds.

status
列挙値
定数:
queued
必須
値
queued
task_id
型: string
必須

Task id to use for polling.
application/json
400
型: object · GenerationError

Invalid request (unknown model, mixed input modes, invalid fields)

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json
401
型: object · GenerationError

Invalid or missing Felo API key

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json
402
型: object · GenerationError

Insufficient balance / billing requirement not met

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json
403
型: object · GenerationError

Account not permitted (subscription required or user banned). Disabled models are also rejected before upstream calls. Existing accepted requests and tasks continue.

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json
429
型: object · GenerationError

Request or spending limit reached

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json
502
型: object · GenerationError

Upstream provider failed

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json
503
型: object · GenerationError

Generation service or billing service temporarily unavailable

OpenAI-compatible error envelope.
error
型: object
message
型: string
必須
type
型: string 列挙値
必須
値
invalid_request_error
server_error
code
型: string
param
型: string null 許容
application/json

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": "seedance-2.0-mini",
  "prompt": "a cinematic trailer shot, 720p",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}'

スキーマを表示

{
  "task_id": "string",
  "status": "queued",
  "kind": "video",
  "outputs": [
    "string"
  ]
}

Task accepted

Submit a video generation task

認証Required

Submit a video generation task