Veo3.1 Fast API-integration
Använd Veo3.1 Fast via Rivyas publika API v1 med modell-ID veo3-1-fast, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.
veo3-1-fast
text, file
Krävs för referenslägen
20
Video
FIXED
5000 tecken
Kontrakt för begäran
Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.
| Nyckel | Typ | Obligatoriskt | Standard | Beskrivning |
|---|---|---|---|---|
| model | string | Ja | veo3-1-fast | Använd API-modell-ID:t veo3-1-fast. |
| prompt | string | Ja | - | Högst 5000 tecken för den här modellen. |
| params | object | Nej | - | Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar. |
| client_request_id | string | Nej | - | Valfritt klient-ID för att spåra begäranden i ditt system. |
Modellparametrar
| Nyckel | Typ | Obligatoriskt | Standard | Intervall | Alternativ | Beskrivning |
|---|---|---|---|---|---|---|
| generationType | select | Nej | FIRST_AND_LAST_FRAMES_2_VIDEO | - | FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO | Genereringsläge |
| aspectRatio | select | Nej | 16:9 | - | 16:9, 9:16, Auto | Bildförhållande |
| watermark | text | Nej | - | - | - | Vattenstämpeltext |
| seeds | number | Nej | - | min 10000 / max 99999 / step 1 | - | Lämna fältet tomt för ett nytt slumpmässigt resultat varje gång. Om du återanvänder samma heltal blir det enklare att återskapa eller finjustera ett tidigare resultat. Det blir bara mer likt när prompten och andra viktiga inställningar också förblir liknande, och en identisk 1:1-matchning garanteras inte. |
| enableTranslation | select | Nej | true | - | true, false | Promptöversättning |
Uppladdningspolicy
Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.
Referensbild: Ladda upp upp till 3 bildfiler för bild- och referensstyrda projekt.
3
image
Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.
| kind | Max storlek | MIME-typer |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimal begäran
{
"model": "veo3-1-fast",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
"aspectRatio": "16:9",
"watermark": "Valfri vattenstämpeltext",
"seeds": 10000,
"enableTranslation": "true"
}
}Begäran med referensfil
{
"model": "veo3-1-fast",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
"aspectRatio": "16:9",
"watermark": "Valfri vattenstämpeltext",
"seeds": 10000,
"enableTranslation": "true",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Skapa-svar
Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.
{
"id": "task_veo3_1_fast_example",
"status": "queued",
"model": "veo3-1-fast",
"reserved_credits": 20,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Vanliga fel
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Vissa lägen kräver referensuppladdningar via Files API.