↓
Docs Rivya AI
Halaman API Model

Integrasi API Veo3.1 Fast

Gunakan Veo3.1 Fast melalui Rivya Public API v1 dengan id model veo3-1-fast, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIVideo
ID model API

veo3-1-fast

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

Tarif kredit: 30–90 / video Biaya akhir tugas dibulatkan ke atas ke kredit utuh.

Kapabilitas

Video

Tagihan

FIXED

Batas prompt

5000 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

KeyTipeWajibDefaultDeskripsi
modelstringYaveo3-1-fastGunakan veo3-1-fast sebagai id model API.
promptstringYa-Maksimum 5000 karakter untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
generationTypeselectTidakTEXT_2_VIDEO-TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEOMode generasi
aspectRatioselectTidak16:9-16:9, 9:16, AutoRasio aspek
resolutionselectTidak720p-720p, 1080p, 4kResolusi
durationselectTidak8-4, 6, 8Durasi
watermarktextTidak---Teks watermark
enableTranslationselectTidaktrue-true, falseTerjemahan prompt

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Gambar referensi: Mode referensi menerima 1–3 JPEG atau PNG terverifikasi, maksimal 10 MB per gambar, hanya 16:9 atau 9:16, dan wajib 8 detik.

File maksimum

3

Jenis file yang diterima

image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kindUkuran maksimumTipe MIME
image10 MBimage/jpeg, image/png

Request minimal

{
  "model": "veo3-1-fast",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "generationType": "TEXT_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "Teks watermark opsional",
    "enableTranslation": "true"
  }
}

Request file referensi

{
  "model": "veo3-1-fast",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "generationType": "TEXT_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "Teks watermark opsional",
    "enableTranslation": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "id": "task_veo3_1_fast_example",
  "status": "queued",
  "model": "veo3-1-fast",
  "reserved_credits": 30,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.