Omni Reference is handig wanneer een prompt alleen niet precies vastlegt welk personage, product, welke beweging of omgeving je nodig hebt. Het draait erom dat je elke referentie een eigen taak geeft: de ene bepaalt het subject, de andere de scène, en een video kan de beweging sturen. Voeg je assets toe zonder de tegenstrijdigheden ertussen op te lossen, dan wordt de taak juist onduidelijker.
Deze tutorial volgt het Kling 4.0-endpoint van PoYo, gecontroleerd op 24 oktober 2026. Wat de officiële creator-app kan en welke API-velden per aanbieder gelden, moet je apart controleren.
Koppel de asset aan het juiste veld
| Rol van de asset | PoYo-veld | Verwijzing in de prompt |
|---|---|---|
| Uiterlijk, scène, product of stijl uit een afbeelding | reference_image_urls | @Image1, @Image2 |
| Beweging, acteerprestatie of camera als referentie | reference_video_urls | @Video1, @Video2 |
| Eén subject dat in meerdere afbeeldingen te zien is | kling_elements[].element_input_urls | @Element1, @Element2 |
| Eén subject dat door een video wordt vastgelegd | kling_elements[].element_input_video_urls | @Element1, @Element2 |
| Exacte openingscompositie | Eén image_urls-item in referentiemodus | Bepaalt het eerste frame |
Subjecten die door afbeeldingen worden vastgelegd, vereisen twee tot vier afbeeldingen van hetzelfde subject, met een frontaal beeld als eerste. Een subject dat door een video wordt vastgelegd, bestaat uit één video. Gebruik per subject één van beide vormen, niet allebei. De nummering van referenties volgt de volgorde binnen elke array; @Element1 is geen objectnaam die de API zelf bedenkt.
Een vastgelegd voorbeeld met twee afbeeldingen
In het kassenvoorbeeld van PoYo is de eerste referentie de volwassen natuuronderzoeker en de tweede de glazen kas als omgeving. Het verzoek noemt de regenjas, de tas en de lantaarn als ankers voor de identiteit en beschrijft daarna een camerabeweging van een detail in close-up naar een bredere onthulling.
De vastgelegde taak BIIA0RLIILB65JTX vroeg om 15 seconden in 1080p, 16:9, met twee referentieafbeeldingen. De vastgelegde afschrijving is 637,5 credits, in lijn met het tarief zonder video van 42,5 credits per seconde output. In het voorbeeld staat de oudere notatie @image_1 en @image_2, die PoYo ook accepteert. In nieuwe verzoeken kun je de duidelijkere vorm @Image1 en @Image2 gebruiken.
Download het oorspronkelijke verzoek en de metadata van het voorbeeld. Kijk of de lantaarn in de bedoelde hand blijft, of gezicht en kleding herkenbaar blijven en of de indeling van de brug samenhangend blijft. Zie dit als vragen voor je beoordeling en niet als eigenschappen die elk referentieverzoek gegarandeerd oplevert.
Begin met twee referenties en duidelijke verantwoordelijkheden
Dit ingekorte patroon gebruikt dezelfde twee rollen. Het is een nieuw sjabloon en niet de exacte prompt waarmee de opgeslagen video is gemaakt:
{
"model": "kling-4.0",
"input": {
"prompt": "Use @Image1 for the adult naturalist's identity, mustard raincoat and brass lantern. Use @Image2 for the glass conservatory and narrow mossy bridge. She takes two careful steps across the bridge, keeping the lantern in her right hand. One slow side-following shot, realistic foot contact and reflections. Do not display reference images as a collage.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": [
"https://storage.poyo.ai/blog/kling-4-0-series-20261024/conservatory-person-0437038b5fbc.png",
"https://storage.poyo.ai/blog/kling-4-0-series-20261024/conservatory-scene-1b878de0f5cc.png"
]
}
}
Wijs bij een product de identiteit toe aan een nette packshot en de compositie aan een aparte scènereferentie. Noem de details die niet mogen afwijken: vorm van de dop, silhouet, materiaal, kleur of plek van het etiket. Als twee afbeeldingen verschillende versies van dezelfde fles tonen, kies dan één leidende versie voordat je gaat genereren.
Tel de limieten voordat je uploadt
PoYo staat maximaal 10 referentieafbeeldingen, vijf referentievideo's en zeven subjecten toe, met hooguit drie subjecten die door een video worden vastgelegd. De gezamenlijke limiet per verzoek is 15 assets. Tel een subject op dat niveau één keer mee; tel niet elke foto binnen een subject als aparte asset op het hoogste niveau. Een optioneel eerste frame telt ook mee voor de limiet van 10 afbeeldingen en 15 assets.
Elke invoervideo moet 3 tot 30 seconden duren. Referentievideo's en subjectvideo's samen mogen niet meer dan 30 echte seconden beslaan. Een verzoek voor referentiegeneratie kan één eerste frame bevatten, maar geen extra laatste frame. Voor een werkwijze met twee grensframes gebruik je gewone afbeelding-naar-video, zonder referentiearrays of subjecten.
Test of een extra referentie helpt
Bewaar een basisversie met één duidelijke identiteitsreferentie. Voeg een scèneafbeelding toe en kijk wat er verandert. Voeg alleen een bewegingsvideo toe als je de camera of de acteerprestatie niet goed genoeg kunt beschrijven. Het doel is minder dubbelzinnigheid, niet het vullen van elk invoerslot.
Beoordeel het begin, het midden en het einde samen. Controleer de kenmerken van het personage, de verhoudingen van het product, de onderlinge positie van objecten en ongewenste montages van referentieafbeeldingen. Als de output na een camerabeweging gaat afwijken, probeer dan eerst een rustigere camera voordat je meer visuele assets toevoegt.
Facturering en niet-ondersteunde velden
Afbeeldingsreferenties en subjecten met alleen afbeeldingen gebruiken het tarief zonder video. Een referentievideo of een subject dat door een video wordt vastgelegd activeert facturering voor video-invoer, inclusief het minimum van tweemaal de outputduur. De prijsgids bevat uitgewerkte voorbeelden.
Het officiële modeloverzicht beschrijft bredere multimodale creatieve workflows. Het huidige schema van PoYo heeft geen veld voor een audioreferentie, voor tien getimede keyframe-afbeeldingen of voor 4K-output. Gebruik de API-gids voor de huidige invoergrenzen en de bewerkingstutorial wanneer het bronmateriaal zelf behouden moet blijven.