v0.4.0

OpenAPI 3.1.0

Hantar tugas penjanaan video

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

Hantar tugas penjanaan video

Mencipta tugas penjanaan video tak segerak dan memulangkan task_id serta-merta (HTTP 202). Semak GET /api/v1/videos/generations/{task_id} secara berkala sehingga berjaya. Badan permintaan boleh diberikan sama ada secara rata ({model, prompt, ...}) atau bersarang ({model, input: {prompt, ...}}); objek input diutamakan apabila hadir. Medan callback (callBackUrl / callback_url / callbackUrl) diabaikan.

Tiga mod input yang saling eksklusif:

teks-ke-video: prompt sahaja;
imej-ke-video (bingkai pertama/terakhir): first_frame_url (+ last_frame_url pilihan);
rujukan omni: reference_image_urls / reference_video_urls / reference_audio_urls. Mencampurkan bingkai pertama/terakhir dengan mana-mana input rujukan multimodal memulangkan 400 invalid_request_error.

Pengepala

X-Request-Id
Jenis: string

ID permintaan pemanggil pilihan yang dipantulkan semula untuk diagnostik.
X-Felo-Channel
Jenis: string

Kod saluran awam yang dipisahkan koma dan tersusun. Tinggalkan pengepala ini untuk menggunakan default; default mesti digunakan secara bersendirian. Dalam mod dompet, default mengimbas susunan saluran awam berkesan model secara terbalik, melangkau saluran yang tidak diterbitkan atau tidak tersedia, dan memilih penyedia saluran pertama yang tersedia. Ia merangkumi endpoint tersedia daripada penyedia itu dengan ID model huluan dan tahap perkhidmatan yang sama. Saluran eksplisit disahkan mengikut susunan yang ditetapkan klien; hanya kumpulan penyedia saluran pertama yang dihantar. Tiada sandaran automatik kepada penyedia lain. Pengepala penyedia legasi tidak boleh mengatasi penghalaan saluran.

Badan·VideoGenerationRequest

wajib

application/json

Input penjanaan video. Sama ada rata ({model, prompt, ...}) atau bersarang ({model, input: {...}}). input diutamakan. Tepat satu mod input mesti digunakan; mencampurkan bingkai pertama/terakhir dengan input rujukan multimodal ditolak.

model
Jenis: string
wajib

Nama model yang dipaparkan kepada Felo, cth. seedance-2.0-mini.
aspect_ratio
Jenis: string enum
nilai
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 21:9
- adaptive
duration
Jenis: integer
min:
4
maks:
15

Integer numbers.
first_frame_url
Jenis: string Format: uri
generate_audio
Jenis: boolean
input
Jenis: object

Objek input bersarang pilihan; apabila hadir, medannya diutamakan berbanding medan bersebelahan.
- aspect_ratio
  Jenis: string enum
  
  Nisbah bidang output; adaptive mengikut nisbah imej input.
  
  nilai
  16:9
  9:16
  1:1
  4:3
  3:4
  21:9
  adaptive
- duration
  Jenis: integer
  min:
  4
  maks:
  15
  
  Tempoh output dalam saat.
- first_frame_url
  Jenis: string Format: uri
  
  URL imej bingkai pertama (mod imej-ke-video).
- generate_audio
  Jenis: boolean
  
  Sama ada untuk menjana trek audio yang disegerakkan.
- last_frame_url
  Jenis: string Format: uri
  
  URL imej bingkai terakhir; mesti digunakan bersama first_frame_url.
- prompt
  Jenis: string
  panjang maksimum:
  2000
  
  Prompt. Diperlukan untuk mod teks-ke-video dan rujukan omni.
- reference_audio_urls
  Jenis: array string[] …3Format: uri
  
  Klip audio rujukan omni.
- reference_image_urls
  Jenis: array string[] …9Format: uri
  
  Imej rujukan omni. Saling eksklusif dengan bingkai pertama/terakhir.
- reference_video_urls
  Jenis: array string[] …3Format: uri
  
  Video rujukan omni. Saling eksklusif dengan bingkai pertama/terakhir. Membekalkan video mengubah harga unit pengebilan dan menambah tempoh input pada kiraan token.
- resolution
  Jenis: string enum
  
  Resolusi output. Resolusi lebih tinggi menggunakan lebih banyak token dan lebih mahal.
  
  nilai
  480p
  720p
  1080p
  4k
- service_tier
  Jenis: string | null
  
  Pada masa ini hanya default (standard) disokong. Nilai yang ditinggalkan, null, alias dan rentetan tidak disokong akan kembali kepada default; jenis lain memulangkan HTTP 400. Saluran dan harga yang dikonfigurasikan kekal tidak berubah. API teks menghantar nilai standard penyedia; API Decisions dan penjanaan meninggalkan medan huluan.
last_frame_url
Jenis: string Format: uri
prompt
Jenis: string
panjang maksimum:
2000
reference_audio_urls
Jenis: array string[] …3Format: uri
reference_image_urls
Jenis: array string[] …9Format: uri
reference_video_urls
Jenis: array string[] …3Format: uri
resolution
Jenis: string enum
nilai
- 480p
- 720p
- 1080p
- 4k

service_tier
Jenis: string | null

Pada masa ini hanya default (standard) disokong. Nilai yang ditinggalkan, null, alias dan rentetan tidak disokong akan kembali kepada default; jenis lain memulangkan HTTP 400. Saluran dan harga yang dikonfigurasikan kekal tidak berubah. API teks menghantar nilai standard penyedia; API Decisions dan penjanaan meninggalkan medan huluan.

Respons

202
Jenis: object · VideoGenerationAccepted

Tugas diterima
kind
enum
const:
video
wajib
nilai
video
outputs
Jenis: array string[]
wajib

Kosong sehingga tugas berjaya.

status
enum
const:
queued
wajib
nilai
queued
task_id
Jenis: string
wajib

ID tugas untuk digunakan semasa menyemak status.
application/json
400
Jenis: object · GenerationError

Permintaan tidak sah (model tidak diketahui, mod input bercampur, medan tidak sah)

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh null
application/json
401
Jenis: object · GenerationError

Kunci API Felo tidak sah atau tiada

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh null
application/json
402
Jenis: object · GenerationError

Baki tidak mencukupi / keperluan pengebilan tidak dipenuhi

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh null
application/json
403
Jenis: object · GenerationError

Akaun tidak dibenarkan (langganan diperlukan atau pengguna disekat). Model yang dilumpuhkan juga ditolak sebelum panggilan huluan. Permintaan dan tugas yang telah diterima terus berjalan.

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh null
application/json
429
Jenis: object · GenerationError

Had permintaan atau perbelanjaan telah dicapai

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh null
application/json
502
Jenis: object · GenerationError

Penyedia huluan gagal

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh null
application/json
503
Jenis: object · GenerationError

Perkhidmatan penjanaan atau perkhidmatan pengebilan tidak tersedia buat sementara waktu

Sampul ralat serasi OpenAI.
error
Jenis: object
message
Jenis: string
wajib
type
Jenis: string enum
wajib
nilai
invalid_request_error
server_error
code
Jenis: string
param
Jenis: string boleh 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
}'

Tunjukkan Skema

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

Tugas diterima

Hantar tugas penjanaan video

PengesahanRequired

Hantar tugas penjanaan video