영상 생성 작업 제출
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와 서비스 티어를 가진 해당 공급자의 사용 가능한 엔드포인트도 포함합니다. 명시적 채널은 클라이언트가 지정한 순서로 검증되며, 첫 번째 채널의 공급자 그룹만 제출됩니다. 다른 공급자로의 자동 fallback은 없습니다. 레거시 공급자 헤더로는 채널 라우팅을 재정의할 수 없습니다.
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"
]
}