v0.4.0

OpenAPI 3.1.0

Gửi tác vụ tạo video

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

Gửi tác vụ tạo video

Tạo một tác vụ tạo video bất đồng bộ và trả về task_id ngay lập tức (HTTP 202). Gọi GET /api/v1/videos/generations/{task_id} định kỳ cho tới khi tác vụ thành công. Phần thân yêu cầu có thể được cung cấp ở dạng phẳng ({model, prompt, ...}) hoặc lồng nhau ({model, input: {prompt, ...}}); đối tượng input được ưu tiên khi có mặt. Các trường callback (callBackUrl / callback_url / callbackUrl) bị bỏ qua.

Ba chế độ nhập loại trừ lẫn nhau:

text-to-video: chỉ prompt;
image-to-video (khung đầu/khung cuối): first_frame_url (+ last_frame_url tùy chọn);
omni-reference: reference_image_urls / reference_video_urls / reference_audio_urls. Trộn khung đầu/khung cuối với bất kỳ đầu vào tham chiếu đa phương thức nào sẽ trả về 400 invalid_request_error.

Header

X-Request-Id
Kiểu: string

ID yêu cầu tùy chọn của bên gọi, được trả về để chẩn đoán.
X-Felo-Channel
Kiểu: string

Mã kênh công khai được phân tách bằng dấu phẩy, có thứ tự. Bỏ trống header này để dùng default; default phải được dùng một mình. Ở chế độ ví, default quét thứ tự kênh công khai hiệu dụng của mô hình theo chiều ngược, bỏ qua các kênh chưa xuất bản hoặc không khả dụng, và chọn nhà cung cấp của kênh khả dụng đầu tiên. Nó bao gồm các endpoint khả dụng của nhà cung cấp đó có cùng ID mô hình upstream và cùng hạng dịch vụ. Các kênh chỉ định rõ được kiểm tra theo thứ tự do client chỉ định; chỉ nhóm nhà cung cấp của kênh đầu tiên được gửi đi. Không tự động dự phòng sang nhà cung cấp khác. Header nhà cung cấp kiểu cũ không thể ghi đè định tuyến kênh.

Phần thân·VideoGenerationRequest

bắt buộc

application/json

Đầu vào tạo video. Ở dạng phẳng ({model, prompt, ...}) hoặc lồng nhau ({model, input: {...}}). input được ưu tiên. Phải dùng đúng một chế độ nhập; trộn khung đầu/khung cuối với đầu vào tham chiếu đa phương thức sẽ bị từ chối.

model
Kiểu: string
bắt buộc

Tên mô hình hiển thị với Felo, ví dụ seedance-2.0-mini.
aspect_ratio
Kiểu: string enum
giá trị
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 21:9
- adaptive
duration
Kiểu: integer
tối thiểu:
4
tối đa:
15

Integer numbers.
first_frame_url
Kiểu: string Định dạng: uri
generate_audio
Kiểu: boolean
input
Kiểu: object

Đối tượng đầu vào lồng nhau tùy chọn; khi có mặt, các trường của nó được ưu tiên hơn các trường cùng cấp.
- aspect_ratio
  Kiểu: string enum
  
  Tỷ lệ khung hình đầu ra; adaptive theo tỷ lệ của hình ảnh đầu vào.
  
  giá trị
  16:9
  9:16
  1:1
  4:3
  3:4
  21:9
  adaptive
- duration
  Kiểu: integer
  tối thiểu:
  4
  tối đa:
  15
  
  Thời lượng đầu ra tính bằng giây.
- first_frame_url
  Kiểu: string Định dạng: uri
  
  URL hình ảnh khung đầu (chế độ image-to-video).
- generate_audio
  Kiểu: boolean
  
  Có tạo bản âm thanh đồng bộ hay không.
- last_frame_url
  Kiểu: string Định dạng: uri
  
  URL hình ảnh khung cuối; phải dùng cùng với first_frame_url.
- prompt
  Kiểu: string
  độ dài tối đa:
  2000
  
  Prompt. Bắt buộc với chế độ text-to-video và omni-reference.
- reference_audio_urls
  Kiểu: array string[] …3Định dạng: uri
  
  Các đoạn âm thanh tham chiếu omni.
- reference_image_urls
  Kiểu: array string[] …9Định dạng: uri
  
  Hình ảnh tham chiếu omni. Loại trừ lẫn nhau với khung đầu/khung cuối.
- reference_video_urls
  Kiểu: array string[] …3Định dạng: uri
  
  Video tham chiếu omni. Loại trừ lẫn nhau với khung đầu/khung cuối. Việc cung cấp video thay đổi đơn giá thanh toán và cộng thêm thời lượng đầu vào vào số token.
- resolution
  Kiểu: string enum
  
  Độ phân giải đầu ra. Độ phân giải cao hơn tiêu tốn nhiều token hơn và tốn kém hơn.
  
  giá trị
  480p
  720p
  1080p
  4k
- service_tier
  Kiểu: string | null
  
  Hiện chỉ hỗ trợ default (tiêu chuẩn). Giá trị bị bỏ trống, null, các bí danh và chuỗi không được hỗ trợ đều quay về default; các loại khác trả về HTTP 400. Các kênh và giá đã cấu hình không thay đổi. API văn bản gửi giá trị tiêu chuẩn của nhà cung cấp; API Decisions và tạo nội dung bỏ qua trường upstream.
last_frame_url
Kiểu: string Định dạng: uri
prompt
Kiểu: string
độ dài tối đa:
2000
reference_audio_urls
Kiểu: array string[] …3Định dạng: uri
reference_image_urls
Kiểu: array string[] …9Định dạng: uri
reference_video_urls
Kiểu: array string[] …3Định dạng: uri
resolution
Kiểu: string enum
giá trị
- 480p
- 720p
- 1080p
- 4k

service_tier
Kiểu: string | null

Hiện chỉ hỗ trợ default (tiêu chuẩn). Giá trị bị bỏ trống, null, các bí danh và chuỗi không được hỗ trợ đều quay về default; các loại khác trả về HTTP 400. Các kênh và giá đã cấu hình không thay đổi. API văn bản gửi giá trị tiêu chuẩn của nhà cung cấp; API Decisions và tạo nội dung bỏ qua trường upstream.

Phản hồi

202
Kiểu: object · VideoGenerationAccepted

Đã tiếp nhận tác vụ
kind
enum
const:
video
bắt buộc
giá trị
video
outputs
Kiểu: array string[]
bắt buộc

Rỗng cho tới khi tác vụ thành công.

status
enum
const:
queued
bắt buộc
giá trị
queued
task_id
Kiểu: string
bắt buộc

ID tác vụ dùng để thăm dò trạng thái.
application/json
400
Kiểu: object · GenerationError

Yêu cầu không hợp lệ (mô hình không xác định, trộn lẫn chế độ nhập, trường không hợp lệ)

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể null
application/json
401
Kiểu: object · GenerationError

Khóa API Felo không hợp lệ hoặc bị thiếu

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể null
application/json
402
Kiểu: object · GenerationError

Số dư không đủ / chưa đáp ứng yêu cầu thanh toán

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể null
application/json
403
Kiểu: object · GenerationError

Tài khoản không được phép (cần đăng ký gói hoặc người dùng bị cấm). Các mô hình đã bị vô hiệu hóa cũng bị từ chối trước khi gọi upstream. Các yêu cầu và tác vụ đã được tiếp nhận vẫn tiếp tục.

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể null
application/json
429
Kiểu: object · GenerationError

Đã đạt giới hạn yêu cầu hoặc chi tiêu

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể null
application/json
502
Kiểu: object · GenerationError

Nhà cung cấp upstream gặp lỗi

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể null
application/json
503
Kiểu: object · GenerationError

Dịch vụ tạo nội dung hoặc dịch vụ thanh toán tạm thời không khả dụng

Phong bì lỗi tương thích OpenAI.
error
Kiểu: object
message
Kiểu: string
bắt buộc
type
Kiểu: string enum
bắt buộc
giá trị
invalid_request_error
server_error
code
Kiểu: string
param
Kiểu: string có thể 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
}'

Hiện schema

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

Đã tiếp nhận tác vụ

Gửi tác vụ tạo video

Xác thựcRequired

Gửi tác vụ tạo video