Google: Veo 3.1

Veo 3.1 ialah model video Google untuk adegan berpandukan teks dan imej dengan bunyi terjana, bingkai sempadan berpandukan arahan dan aset rujukan. Profil produksinya menyediakan klip empat, enam atau lapan saat pada 24 fps, dengan pilihan output termasuk 720p, 1080p dan 4K.

Ailoot Ultra · Video POST /v1/videos google/veo-3.1

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Veo 3.1 ialah model penjanaan video Google untuk mencipta adegan audiovisual ringkas daripada teks atau arahan berpandukan imej. Profil produksinya menyokong teks-ke-video, imej-ke-video dan penciptaan berpandukan bingkai pertama/akhir, dengan bunyi terjana, rujukan aset serta aliran sambungan berasingan. Gunakannya untuk membangunkan konsep sinematik, naratif produk ringkas atau segmen visual dengan adegan, tindakan dan pengalaman mendengar yang ditetapkan.

Huraikan subjek dan peristiwa yang kelihatan dahulu. Tetapkan persekitaran, waktu dan cahaya, kemudian tentukan sudut pandangan atau gerakan kamera serta gaya visual dimaksudkan. Contoh arahan adegan asli boleh menunjukkan bekas kaca di atas permukaan studio gelap, dengan gerakan sisi perlahan mendedahkan pantulan sementara bunyi persekitaran lembut mengiringinya. Setiap arahan memberikan ciri yang boleh dilihat atau didengar dan dinilai dalam hasil siap.

Rangka prompt Google menganggap subjek, tindakan, adegan, kamera dan estetika sebagai bahagian arahan berasingan. Gunakan bahagian yang membantu syot tanpa menambah setiap penerang yang mungkin. Tulis arahan dalam bahasa Inggeris untuk profil prompt yang didokumenkan. Jika adegan mempunyai beberapa tindakan, nyatakan hubungannya dan pastikan sepadan dengan klip ringkas supaya pendedahan atau reaksi kekal jelas.

Imej permulaan menetapkan rupa dan komposisi pembukaan. Gunakannya apabila watak, produk atau latar sudah wujud sebagai aset visual, dan huraikan gerakan yang perlu berkembang daripadanya. Bingkai akhir menambah komposisi sasaran untuk penamat. Sediakan bingkai sempadan yang menyampaikan peralihan munasabah dan mengekalkan butiran pengenalan subjek utama, kemudian periksa gerakan antara bingkai selepas penjanaan.

Rujukan aset mempunyai tujuan lain: ia memandu rupa watak atau objek dalam adegan baharu yang dijana, sementara bingkai sempadan menentukan detik tertentu dalam adegan itu. Pilih rujukan yang menunjukkan ciri visual penting dan jelaskan peranan setiap aset dalam prompt. Spesifikasi imej-rujukan-ke-video model produksi menggunakan output lapan saat bagi aliran rujukan itu, berasingan daripada pemilihan tempoh biasa berpandukan teks.

Profil produksi biasa pengeluar menjana klip empat, enam atau lapan saat pada 24 bingkai sesaat. Ia menyenaraikan pembingkaian landskap 16:9 dan potret 9:16, sehingga empat output video bagi setiap prompt serta resolusi output 720p, 1080p dan 4K. Format video output ialah MP4. Spesifikasi berpandukan imej menerima JPEG atau PNG, menyenaraikan maksimum imej input 20 MB dan menyokong konfigurasi input 720p/1080p. Pilih profil output untuk tempat penggunaan dimaksudkan dan pastikan komposisi bingkai jelas pada saiz itu.

Bunyi natif boleh mengiringi adegan yang kelihatan. Nyatakan baris pertuturan, suasana dan kesan bunyi sebagai bahagian arahan yang sama, dengan menamakan subjek atau peristiwa yang menghasilkan setiap satu. Arahan dialog dan arahan kamera menjawab persoalan berbeza: satu menetapkan persembahan, satu lagi cara penonton melihatnya. Pastikan perkataan muat dalam masa pertuturan berguna klip dan semak kejelasan bunyi serta hubungannya dengan tindakan.

Untuk sambungan, pengeluar menyediakan aliran pelanjutan video berasingan. Mulakan daripada klip sumber terjana yang sesuai dan huraikan peristiwa kelihatan atau perubahan adegan seterusnya. Simpan segmen asal dan sambungan supaya titik cantumannya dapat disemak dari segi rupa, gerakan dan bunyi. Pilihan tempoh dan resolusi penjanaan baharu biasa tidak sepatutnya dianggap kontrak sejagat untuk setiap operasi pelanjutan.

Penerangan negatif boleh memfokuskan pengecualian pada keperluan visual tugas. Untuk satu siri variasi produk, kekalkan subjek dan komposisi sambil mengubah satu arah kreatif, seperti pencahayaan atau jarak kamera. Rekodkan prompt, rujukan dan tetapan pilihan bersama hasil. Ini membolehkan perbezaan kreatif berguna dibandingkan, bukannya himpunan penjanaan yang tidak berkaitan.

Profil produksi Veo 3.1 biasa dan Veo 3.1 Fast mempunyai profil resolusi output berbeza. Fast menyenaraikan 720p dan 1080p; 3.1 biasa turut menyenaraikan 4K. Kekalkan edisi pilihan bersama hasil tanpa menggantikan pengecam model produksi dengan profil Preview lebih lama atau generasi Veo lain secara senyap. Rupa subjek serta operasi yang disokong bergantung pada aliran pilihan.

Penjanaan ialah operasi yang hasil siapnya menyediakan aset video untuk dimainkan dan disunting kemudian. Simpan fail yang dikembalikan bersama bingkai sumber, aset rujukan dan arahan, serta kekalkan maklumat asal usul kandungan yang dibekalkan. Periksa setiap output sebenar dari segi rupa subjek, tindakan, pembingkaian, bunyi dan komposisi akhir. Gunakan klip pilihan sebagai komponen produksi, dengan tajuk, peralihan atau kerja kemasan lain ditambah dalam suntingan sekeliling.

Ailoot Ultra · Video POST /v1/videos google/veo-3.1

google/veo-3.1

Google /google/veo-3.1

Pengenalan

Input yang diterima: Teks
Hasil: Video

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Video POST /v1/videos

Input: text
Output: video
Format output: mp4
Bilangan output: Sehingga 4 outputs

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had google/veo-3.1	Lalai—
Medan`prompt`	Jenis`string`	KeperluanDiperlukan	Nilai & had Bait UTF-8 maksimum: 10,000 Aksara selain ruang kosong diperlukan: Ya	Lalai—
Medan`duration`	Jenis`integer`	KeperluanDiperlukan	Nilai & had 4, 6, 8	Lalai—
Medan`resolution`	Jenis`string`	KeperluanDiperlukan	Nilai & had 720p	Lalai—
Medan`aspect_ratio`	Jenis`string`	KeperluanDiperlukan	Nilai & had 16:9, 9:16	Lalai—
Medan`generate_audio`	Jenis`boolean`	KeperluanDiperlukan	Nilai & had false, true	Lalai—

Gabungan bahan input

Teks kepada video · Diperlukan: prompt

Parameter kaedah dan kitar hayat

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, prompt, duration, resolution, aspect_ratio, generate_audio
Parameter`additional_properties`	Kontrakfalse
Parameter`parameters`	Kontrak{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]}
Parameter`material_types`	Kontraktext

Alias kaedah: /v1/videos/generations, /videos, /videos/generations

Kitar hayat: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Simpan respons lengkap dan ID asal yang dikembalikan.

Jangan sekali-kali hantar semula penciptaan yang tidak diketahui hasilnya.

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	Jana audio	Resolusi	Unit pengebilan	Syarat pengebilan	Caj
KonfigurasiKadar asas token	Jadual kadarKadar asas	Kuantiti ramalan—	Jana audio—	Resolusi—	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
KonfigurasiUltra	Jadual kadar—	Kuantiti ramalanKonfigurasi yang diminta; anggaran sahaja.	Jana audioDengan audio	Resolusi720p	Unit pengebilanbagi setiap saat video keluaran	Syarat pengebilan—	Caj Output · Anggaran saat video keluaran · Anggaran untuk perbandingan sahaja $0.8 bagi setiap saat video keluaran Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira daripada kos yang direkodkan bagi penjanaan asal. Tempoh fizikal video bukan kuantiti yang boleh dibilkan.
KonfigurasiHarga video	Jadual kadar—	Kuantiti ramalan—	Jana audio—	Resolusi—	Unit pengebilanbagi setiap saat video	Syarat pengebilantetapan audio: with_audio; resolusi: 4k	Caj Output · Harga video · Anggaran untuk perbandingan sahaja $1.2 bagi setiap saat video
KonfigurasiUltra	Jadual kadar—	Kuantiti ramalanKonfigurasi yang diminta; anggaran sahaja.	Jana audioTanpa audio	Resolusi720p	Unit pengebilanbagi setiap saat video keluaran	Syarat pengebilan—	Caj Output · Anggaran saat video keluaran · Anggaran untuk perbandingan sahaja $0.4 bagi setiap saat video keluaran Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira daripada kos yang direkodkan bagi penjanaan asal. Tempoh fizikal video bukan kuantiti yang boleh dibilkan.
KonfigurasiHarga video	Jadual kadar—	Kuantiti ramalan—	Jana audio—	Resolusi—	Unit pengebilanbagi setiap saat video	Syarat pengebilantetapan audio: without_audio; resolusi: 4k	Caj Output · Harga video · Anggaran untuk perbandingan sahaja $0.8 bagi setiap saat video
KonfigurasiAnggaran kos penjanaan	Jadual kadar—	Kuantiti ramalananggaran untuk satu penjanaan	Jana audio—	Resolusi—	Unit pengebilan—	Syarat pengebilan—	Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $1.6 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

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

Konfigurasi	Syarat pengebilan	Caj
KonfigurasiHarga video	Syarat pengebilantetapan audio: with_audio	Caj Output · Harga video $0.8 bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.
KonfigurasiHarga video	Syarat pengebilantetapan audio: with_audio; resolusi: 4k	Caj Output · Harga video $1.2 bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.
KonfigurasiHarga video	Syarat pengebilantetapan audio: without_audio	Caj Output · Harga video $0.4 bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.
KonfigurasiHarga video	Syarat pengebilantetapan audio: without_audio; resolusi: 4k	Caj Output · Harga video $0.8 bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.

Contoh permintaan

Ailoot Ultra · Video

curl · profil terkonfigurasi yang tepat

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
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

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Semak status tugas

GET status operasi asal

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

Simpan setiap output selesai yang menjadi milik anda

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 URL bertandatangan milik anda dalam data[] yang lengkap dan metadata status penuh. Simpan setiap output, termasuk audio yang dijana. Trek audio AAC yang sah boleh hadir walaupun generate_audio=false; simpan keseluruhan MP4 asal termasuk audio tersebut.

Jika respons asal perlu disemak

Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.

Output maksimum: 4.

Medan respons

Medan	Jenis	Maksud
Medan`id`	Jenisstring	Maksud—
Medan`object`	Jenisstring	Maksud—
Medan`model`	Jenisstring	Maksud—
Medan`status`	Jenisstring	Maksud—
Medan`data[]`	Jenissigned content URL	Maksud—
Medan`charge_pending_check`	Jenisboolean	Maksud—
Medan`error.code`	Jenisstring	Maksud—
Medan`error.message`	Jenisstring	Maksud—
Medan`operation_id`	Jenisstring	MaksudRespons status/kandungan asal HTTP503 result_pending_check: ID video awam asal yang sama sebagai id.
Medan`error.type`	Jenisstring	Maksudserver_error pada HTTP503 result_pending_check.

Ralat dan langkah seterusnya

Respons	Syarat	Langkah seterusnya
Respons400 · `invalid_request_error`	SyaratPembacaan badan permintaan mentah gagal sebelum profil video dihuraikan	Langkah seterusnyaSimpan respons yang dikembalikan dan betulkan badan permintaan yang tidak dapat dibaca.
Respons422 · `price_unavailable`	SyaratProfil video tepat gagal dihuraikan, atau profil penuh yang telah dihuraikan tidak mempunyai kad harga tepat yang sedia digunakan	Langkah seterusnyaSimpan respons; gunakan profil lengkap dan tepat yang dibenarkan berserta kadnya yang diterbitkan. Cabang ini berjalan sebelum penghantaran kepada pembekal.
Respons409 · `video_not_ready`	SyaratKandungan hasil asal belum tersedia	Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After.
Respons`server_error`	SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan	Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan.
Respons503 · `result_pending_check`	SyaratGET status/kandungan asal: tugas belum diterbitkan, tugas asal bukan failed/cancelled/expired, dan keadaan setempat ialah unknown atau status tugas asal ialah completed.	Langkah seterusnyaSimpan id dan operation_id asal (ID video awam yang sama), respons serta pengepala; baca status/kandungan asal sahaja. Jangan sekali-kali hantar permintaan penjanaan baharu.

Alias

Alias model

Ailoot Ultra google/veo-3.1

Alias laluan kaedah

/v1/videos/generations, /videos, /videos/generations

ID pemanggil berkaitan

google/veo-3.1

FAQ · Google: Veo 3.1

Apakah input dan hasil yang tersedia?: POST /v1/videos · google/veo-3.1: text → video
Apakah medan yang digunakan oleh permintaan?: POST /v1/videos · google/veo-3.1: model, prompt, duration, resolution, aspect_ratio, generate_audio

Google: Veo 3.1

Google: Veo 3.1

Pengenalan

Tersedia di Ailoot · input & kaedah

Pelan harga

Cara caj akhir dikira

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Butiran tarif rujukan

Harga mengikut konfigurasi

Contoh permintaan

Ailoot Ultra · Video

Terima dan simpan hasil

Ailoot Ultra · Video

Semak status tugas

Simpan semua hasil yang selesai

Jika respons asal perlu disemak

Alias

Alias model

Alias laluan kaedah

ID pemanggil berkaitan

Syarikat dan portfolio projeknya

Beli token dengan diskaun.

Sambungkan API kepada produk yang anda jual.