Runway: Gen-4.5
Runway Gen-4.5 mencipta video daripada penerangan adegan atau imej dengan arahan gerakan. Klip 2–10 saat, prompt kamera yang jelas serta pilihan komposisi teks-ke-video dan imej-ke-video yang berasingan menyokong konsep sinematik, B-roll dan adegan visual beranimasi.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Runway Gen-4.5 ialah model penjanaan video dengan mod teks-ke-video dan imej-ke-video. Ia boleh mengikuti taklimat yang menerangkan komposisi adegan, tindakan subjek, koreografi kamera dan urutan peristiwa. Hasil berguna ialah syot janaan pendek yang boleh disemak, disimpan atau disusun bersama rakaman lain.
Pilih mod input untuk syot
Teks-ke-video bermula daripada penerangan adegan bertulis. Sertakan kandungan yang kelihatan serta gerakan: subjek, latar, pencahayaan, pembingkaian, tindakan dan tingkah laku kamera. Mod ini berguna untuk adegan baharu, B-roll, plat latar atau konsep visual yang bingkai permulaannya tidak perlu menghasilkan semula imej yang dibekalkan.
Imej-ke-video bermula daripada imej yang bertindak sebagai bingkai pertama. Imej itu membekalkan komposisi, subjek, pencahayaan dan gaya. Tumpukan prompt bertulis pada apa yang patut berlaku seterusnya: tindakan subjek, pergerakan dalam persekitaran, gerak kamera dan perkembangan syot.
Sediakan imej jelas yang sudah memperlihatkan butiran penting. Wajah kabur, tangan atau artifak lain boleh menjadi lebih ketara apabila dianimasikan. Rujukan yang menunjukkan gerakan pantas melalui debu atau kekaburan gerakan turut boleh bercanggah dengan prompt yang meminta subjek tidak bergerak.
Terangkan visual dan gerakan secara langsung
Gunakan bahasa semula jadi yang jelas dan penerangan positif tentang hasil yang dimaksudkan. Taklimat teks-ke-video boleh menyatakan pandangan kamera, subjek dan tindakan dahulu, kemudian menambah olahan adegan. Penerangan terperinci berguna apabila syot mempunyai keperluan tertentu; penerangan lebih mudah memberikan lebih ruang untuk penerokaan. Tiada bilangan perkataan ideal yang boleh menggantikan kejelasan.
Contohnya, terangkan pandangan dekat lampu meja loyang ketika cahayanya menyala, diikuti gerak kamera perlahan yang mendedahkan buku nota di sebelahnya. Nyatakan bahan dan cahaya yang kelihatan untuk teks-ke-video. Jika imej yang dibekalkan sudah menetapkan butiran itu, prompt imej-ke-video boleh menumpukan pada perubahan cahaya dan pendedahan oleh kamera.
Elakkan arahan bercanggah. Pandangan kamera terkunci dengan gerakan subjek halus berbeza daripada syot penjejakan kamera tangan yang bertenaga. Tambah butiran yang menentukan syot berguna, bukannya senarai panjang gaya visual yang tidak berkaitan.
Istilah kamera dan tindakan berurutan
Panduan kamera pembuat membezakan pembingkaian, sudut, pergerakan dan fokus. Syot dekat mengubah apa yang memenuhi bingkai, sudut rendah mengubah perspektif, pan memutar pandangan kamera dan gerakan penjejakan mengikuti subjek. Arahan rack-focus mengalihkan fokus antara subjek yang kelihatan. Nyatakan apa yang patut kelihatan atau didedahkan semasa pergerakan berkembang.
Prompt berurutan boleh menyatakan peristiwa dalam bahasa biasa atau dengan cap masa kasar. Cap masa itu membimbing urutan dan pemasaan anggaran; ia bukan jaminan pelaksanaan tepat pada bingkai. Berikan tindakan yang diminta masa cukup untuk berlaku secara semula jadi dalam tempoh klip terpilih.
Untuk syot statik, terangkan gerakan yang berlaku dalam bingkai dan tegaskan kamera yang patut kekal pegun. Pembuat menyatakan bahawa pandangan tanpa sebarang gerakan boleh sukar dicapai, khususnya bagi sesetengah syot luas atau pengenalan. Semak gerakan kecil tidak dikehendaki dalam hasil sebenar, bukannya menganggap frasa kamera statik menjadikannya mustahil.
Tempoh, dimensi dan kadar bingkai
Gen-4.5 menyokong tempoh klip daripada 2 hingga 10 saat. Pilihan lebih panjang boleh memuatkan beberapa tindakan berurutan, manakala reaksi atau pendedahan ringkas boleh menggunakan syot lebih pendek. Output yang didokumentasikan ialah 720p, dengan 24 atau 25 bingkai sesaat dalam aliran kerja penjanaan pembuat.
Spesifikasi teks-ke-video menyenaraikan 16:9 pada 1280 × 720 piksel. Imej-ke-video turut menyenaraikan 9:16 pada 720 × 1280, 1:1 pada 960 × 960, 4:3 pada 1104 × 832, 3:4 pada 832 × 1104 dan 21:9 pada 1584 × 672. Kekalkan mod bersama dimensi sebenar, bukannya menganggap kedua-dua mod input menawarkan set nisbah aspek sama.
Nisbah imej boleh menetapkan komposisi lalai, dan mengubahnya boleh memangkas input. Periksa peletakan subjek sebelum menilai gerakan: tindakan yang betul tidak berguna jika bahagian utama imej sumber telah terpotong.
Bina urutan lebih panjang daripada syot lengkap
Untuk kerja berpandukan imej, pembuat menerangkan sambungan urutan dengan menggunakan bingkai terakhir klip lengkap sebagai input imej bagi penjanaan lain. Klip kemudian digabungkan dalam penyunting video, dengan bingkai bersama dan pemasaannya dikendalikan dalam suntingan. Ini ialah urutan syot berasingan, bukannya satu penjanaan tanpa had tempoh.
Simpan bingkai akhir dan taklimat sepadan supaya syot seterusnya bermula daripada keadaan visual yang dimaksudkan. Periksa kesinambungan dalam rakaman bercantum, termasuk rupa subjek, arah kamera dan peralihan antara klip.
Simpan dan semak artifak produksi
Selepas penjanaan, semak seluruh klip dan simpan output lengkap. Aliran kerja pengeluar turut menyediakan pilihan pembesaran serta eksport produksi berasingan seperti ProRes atau urutan PNG. Itu ialah pilihan aliran kerja tambahan; dimensi penjanaan natif tetap berbeza daripada hasil yang dibesarkan kemudian.
Gunakan Gen-4.5 untuk konsep sinematik, idea visual beranimasi, B-roll dan pembangunan adegan pendek. Simpan prompt, imej input jika digunakan, tempoh, mod dan klip yang dipulangkan bersama. Periksa urutan tindakan, tingkah laku kamera, butiran subjek, potongan tidak dikehendaki dan pembingkaian yang dimaksudkan, kemudian buat pembetulan tertumpu pada syot.
Ailoot Ultra · Video POST /v1/videos runway/gen-4.5
runway/gen-4.5Pengenalan
Runway Gen-4.5 mencipta video daripada penerangan adegan atau imej dengan arahan gerakan. Klip 2–10 saat, prompt kamera yang jelas serta pilihan komposisi teks-ke-video dan imej-ke-video yang berasingan menyokong konsep sinematik, B-roll dan adegan visual beranimasi.
- Input yang diterima
- Teks · Imej
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Video POST /v1/videos
- Input
text,image- Output
video- Format output
- bait MP4 asal; tanpa penormalan atau pengekodan semula
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had runway/gen-4.5 | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanduration | Jenisinteger | KeperluanDiperlukan | Nilai & had 2, 3, 4, 5, 6, 7, 8, 9, 10 Minimum: 1 Maksimum: 600 | Lalai— |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 720p | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 9:16 | Lalai— |
Medangenerate_audio | Jenisboolean | KeperluanPilihan | Nilai & had false | Lalai— |
Medanframe_images | Jenisarray | KeperluanPilihan | Nilai & had Item minimum: 1 Item maksimum: 1 Kandungan input: Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame. Setiap peranan bingkai boleh muncul paling banyak sekali. Kunci tepat: type, image_url, frame_type Syarat: Kunci ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja. | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had | Lalai— |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had 1280x720, 720x1280 Corak: ^[1-9][0-9]*x[1-9][0-9]*$ | Lalai— |
Medanseed | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: -9,223,372,036,854,775,808 Maksimum: 9,223,372,036,854,775,807 | Lalai— |
Medancallback_url | Jenisstring | KeperluanPilihan | Nilai & had Corak: ^https:// | Lalai— |
Medansession_id | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medantrace | Jenisobject | KeperluanPilihan | Nilai & had | Lalai— |
Medanuser | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Gabungan bahan input
Teks kepada video · Prompt bertulis. · Diperlukan: model, prompt, duration
Berikan prompt sebagai teks dan tempoh dalam saat bulat. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.
model: Jenis: string · runway/gen-4.5
prompt: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya
Imej kepada video · Prompt bertulis dan imej bingkai pertama. · Diperlukan: model, prompt, duration, frame_images
frame_images ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.
Kunci tepat: type, image_url, frame_type
model: Jenis: string · runway/gen-4.5
prompt: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, duration |
Parametermaterial_types | Kontraktext, image |
Parameteradditional_properties | Kontrakfalse |
Parameteroptional_controls | Kontrakresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Kitar hayat: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Unit pengebilan | Syarat pengebilan | Caj |
|---|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit pengebilan— | Syarat pengebilan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini. | Caj Output · Harga video · Anggaran untuk perbandingan sahaja $0.24 bagi setiap saat video |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Syarat pengebilan— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.48 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Butiran tarif rujukan
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
Rujukan harga konfigurasi video
Harga mengikut konfigurasi
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiHarga video | Syarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini. | Caj Output · Harga video $0.24 bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |
Contoh permintaan
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"runway/gen-4.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Terima dan simpan hasil
Ailoot Ultra · Video
pautan kandungan bertandatangan milik anda
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Semak status tugas
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Pembacaan kandungan lain
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Simpan setiap output sebenar milik anda berserta metadata ukuran yang dikembalikan.
Jika respons asal perlu disemak
503 result_pending_check + id asal + X-Should-Retry:false; jangan sekali-kali ulang operasi asal
Medan respons
| Medan | Jenis | Maksud |
|---|---|---|
Medanindex | Jenisinteger | MaksudKedudukan video ini dalam senarai output dengan indeks bermula dari sifar. |
Medancontent_url | Jenisstring | MaksudURL muat turun HTTPS bertandatangan untuk video siap ini. |
Medansha256 | Jenisstring | null | MaksudRingkasan SHA-256 bagi bait video asal; null jika tidak tersedia. |
Medansize_bytes | Jenisinteger | null | MaksudSaiz fail video asal dalam bait; null jika tidak tersedia. |
Medanduration_ms | Jenisinteger | null | MaksudTempoh video yang diukur dalam milisaat; null jika tidak tersedia. |
Medanwidth | Jenisinteger | null | MaksudLebar video dalam piksel; null jika tidak tersedia. |
Medanheight | Jenisinteger | null | MaksudKetinggian video dalam piksel; null jika tidak tersedia. |
Medanvideo_codec | Jenisstring | null | MaksudPengecam codec video; null jika tidak direkodkan. |
Medanhas_audio | Jenisboolean | null | MaksudSama ada video mengandungi trek audio; null jika tidak diukur. |
Medanaudio_codec | Jenisstring | null | MaksudPengecam codec audio; null apabila tiada pengecam direkodkan. |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons404 · not_found_error | SyaratAkses video tidak tersedia, atau ID video ini tidak ditemui. | Langkah seterusnyaSemak akses video. Untuk video sedia ada, gunakan ID awam asalnya dan kunci API yang sama. |
Respons401 · authentication_error | SyaratKunci API tidak sepadan dengan akaun yang disahkan. | Langkah seterusnyaSemak kunci API dan akses akaun anda sebelum menghantar. |
Respons400 · invalid_request_error | SyaratPermintaan tidak dapat dibaca, atau indeks muat turun tidak sah. | Langkah seterusnyaBetulkan badan permintaan. Untuk muat turun, pilih indeks output yang dikembalikan oleh tugas asal. |
Respons422 · price_unavailable | SyaratHarga konfigurasi video yang dipilih tidak dapat ditentukan. | Langkah seterusnyaPilih konfigurasi video yang disokong dan lengkapkan pilihan wajibnya sebelum menghantar permintaan yang dibetulkan. |
Respons422 · invalid_request_error | SyaratInput video atau tugas sambungan asal tidak sah. | Langkah seterusnyaGunakan input HTTPS yang sah. Untuk sambungan, gunakan ID video awam asal anda yang telah siap dengan kunci API yang sama. |
Respons402 · billing_error | SyaratBaki atau had yang tersedia tidak membenarkan penahanan dana. | Langkah seterusnyaSemak baki dan had yang tersedia sebelum menghantar permintaan baharu. |
Respons503 · server_error | SyaratPengesahan video, storan atau akses perkhidmatan tidak tersedia buat sementara waktu. | Langkah seterusnyaTunggu sehingga perkhidmatan tersedia. Jika anda sudah mempunyai ID video, semak tugas asal tersebut dan jangan cipta penjanaan lain. |
Respons503 · result_pending_check | SyaratHasil video asal dan caj perlu disemak. | Langkah seterusnyaSimpan ID video yang dikembalikan dan semak tugas tersebut. Jangan hantar permintaan penjanaan gantian semasa semakan sedang berjalan. |
Respons503 · owned_result_unavailable | SyaratMuat turun video sedia ada tidak tersedia buat sementara waktu. | Langkah seterusnyaSemak tugas video yang sama kemudian dan muat turun output sedia ada. Penjanaan baharu mencipta operasi berasingan. |
Respons409 · video_not_ready | SyaratKandungan video belum diterbitkan. | Langkah seterusnyaSemak status tugas asal. Muat turun selepas statusnya melaporkan completed; jika statusnya melaporkan failed, ikuti notis semakan cajnya. |
Alias
Alias model
Ailoot Ultra runway/gen-4.5
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Runway: Gen-4.5
- Apakah input dan hasil yang tersedia?
POST /v1/videos·runway/gen-4.5:text,image→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·runway/gen-4.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Apakah had yang terpakai?
POST /v1/videos·runway/gen-4.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807