Léim chuig an ábhar

Kling 4.0 Reference to Video

Comhtháthú

Aitheantas na samhla kling/v4/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Comhaid cosúil leis an sampla: $1.175 1,175 gcreidmheas API déantar do chuid comhad a thomhas roimh an rith Rith ar an leathanach seo

Faigh eochair API
Kling Tagairt go Físeán Ionchuir tagartha3–30 ssuas le 1080p #reference-to-video#multi-shot#image-reference#video-reference

Gineann físeáin 3-30 soicind a choinníonn cuma suas le 10 n-íomhá thagartha, 5 fhíseán thagartha agus 7 n-eilimint

Kling · Físeán

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

88 / 2500

Treoracha giniúna a chomhlíonann an riachtanas `prompt` nó `multi_prompt` a sholáthar. Chun tagairt a dhéanamh d'ionchuir soláthraithe, úsáid @Image1, @Video1, @Element1, agus mar sin de.

video_urls
Scaoil comhad, nó · suas le 5

Suas le 5 fhíseán tagartha, a n-úsáidtear @Video1, @Video2, agus mar sin de chun tagairt dóibh; maireann gach ceann 3–30 soicind (30.05 soicind ar a mhéad), agus ní féidir lena bhfad iomlán le físeáin eiliminte dul thar 30 soicind. Ní féidir le gach comhad a bheith níos mó ná 300 MB, le leithead agus airde idir 700 px agus 4553 px. Caithfidh an cóimheas gné a bheith idir 0.40 agus 2.50, agus an ráta fráma idir 23.9 agus 60.05 FPS.

resolution réamhshocrú 1080p

Taifeach an aschuir.

aspect_ratio réamhshocrú 16:9

Comhréireanna físeáin, roghnaithe go sonrach nó díorthaithe ó na tagairtí trí 'auto' a roghnú.

réamhshocrú 5

Fad an fhíseáin ina soicindí, ó 3 go 30.

Ardleibhéal image · images · multi_prompt · elements
start_image_url
Scaoil comhad, nó

Íomhá roghnach den chéad fhráma a áirítear i dteorainn na n-íomhánna tagartha. Is é 30.0 MB uasmhéid an chomhaid; caithfidh an leithead agus an airde a bheith 300 px ar a laghad, le cóimheas gné idir 0.40 agus 2.50.

image_urls
Scaoil comhad, nó · suas le 10

Íomhánna tagartha a n-úsáidtear @Image1, @Image2, agus mar sin de chun tagairt dóibh, le 10 n-íomhá ar a mhéad. Tá gach comhad teoranta do 30.0 MB, caithfidh 300 px ar a laghad a bheith sa dá thoise, agus caithfidh cóimheas gné idir 0.40 agus 2.50 a bheith aige.

Treoracha giniúna seat ar sheat, agus gach leid ag sainmhíniú seat amháin a chuireann a fhad le fad iomlán an fhíseáin.

Bailiúchán de suas le 7 gcarachtar nó réad, agus féadfaidh 3 ar a mhéad `voice_id` a áireamh agus féadfaidh 3 ar a mhéad físeán a úsáid. Déan tagairt do na heilimintí seo mar @Element1, @Element2, agus mar sin de.

POST /run/kling/v4/reference-to-video?wait=20 luachan → $1.175
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Kling 4.0 Reference to Video

Cruthaíonn sé físeán ó `prompt` téacs chomh maith le híomhánna thagartha, físeáin thagartha agus eilimintí carachtair nó réada, a luaitear sa phrompt mar @Image1, @Video1 nó @Element1. Maireann sé idir 3 agus 30 soicind (5 de réir réamhshocraithe), le haschur ag 720p nó 1080p agus cóimheasa gné auto, 16:9, 9:16, 1:1 nó 21:9. Úsáid `multi_prompt` le haghaidh promptanna in aghaidh an seat, agus sa chás sin is ionann an fad iomlán agus suim fhaid na seatanna. Is iad na teorainneacha ná 10 n-íomhá, 5 fhíseán 3-30s an ceann, agus 7 n-eilimint, agus is féidir guth a bheith ag suas le 3 cinn díobh.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
promptroghnach
Cineálstring | null
≤ 2,500 gcarachtar
Treoracha giniúna a chomhlíonann an riachtanas `prompt` nó `multi_prompt` a sholáthar. Chun tagairt a dhéanamh d'ionchuir soláthraithe, úsáid @Image1, @Video1, @Element1, agus mar sin de.
multi_promptroghnach
Cineálobject[]
Treoracha giniúna seat ar sheat, agus gach leid ag sainmhíniú seat amháin a chuireann a fhad le fad iomlán an fhíseáin.
multi_prompt[].promptriachtanach
Cineálstring
1 – 512 characters
Treoracha téacs don seat reatha.
multi_prompt[].durationroghnach
Cineálinteger
Réamhshocrú5
1 – 30
Fad seat aonair, tomhaiste ina soicindí.
durationroghnach
Cineálinteger
Réamhshocrú5
3 – 30
Fad an fhíseáin ina soicindí, ó 3 go 30.
start_image_urlroghnach image
Cineálurl · image
Íomhá roghnach den chéad fhráma a áirítear i dteorainn na n-íomhánna tagartha. Is é 30.0 MB uasmhéid an chomhaid; caithfidh an leithead agus an airde a bheith 300 px ar a laghad, le cóimheas gné idir 0.40 agus 2.50.
image_urlsroghnach images
Cineálurl[] · image
≤ 10 mír
Íomhánna tagartha a n-úsáidtear @Image1, @Image2, agus mar sin de chun tagairt dóibh, le 10 n-íomhá ar a mhéad. Tá gach comhad teoranta do 30.0 MB, caithfidh 300 px ar a laghad a bheith sa dá thoise, agus caithfidh cóimheas gné idir 0.40 agus 2.50 a bheith aige.
video_urlsroghnach videos
Cineálurl[] · video
≤ 5 mhír
Suas le 5 fhíseán tagartha, a n-úsáidtear @Video1, @Video2, agus mar sin de chun tagairt dóibh; maireann gach ceann 3–30 soicind (30.05 soicind ar a mhéad), agus ní féidir lena bhfad iomlán le físeáin eiliminte dul thar 30 soicind. Ní féidir le gach comhad a bheith níos mó ná 300 MB, le leithead agus airde idir 700 px agus 4553 px. Caithfidh an cóimheas gné a bheith idir 0.40 agus 2.50, agus an ráta fráma idir 23.9 agus 60.05 FPS.
elementsroghnach
Cineálobject[]
≤ 7 mír
Bailiúchán de suas le 7 gcarachtar nó réad, agus féadfaidh 3 ar a mhéad `voice_id` a áireamh agus féadfaidh 3 ar a mhéad físeán a úsáid. Déan tagairt do na heilimintí seo mar @Element1, @Element2, agus mar sin de.
elements[].frontal_image_urlroghnach
Cineálurl · image
Íomhá aghaidh chun tosaigh a thaispeánann príomhamharc na heiliminte. Is é 30.0 MB uasmhéid an chomhaid; caithfidh an dá thoise a bheith 300 px ar a laghad, agus caithfidh an cóimheas gné a bheith idir 0.40 agus 2.50.
elements[].reference_image_urlsroghnach
Cineálurl[] · image
≤ 3 items
Íomhánna forlíontacha a thaispeánann uillinneacha éagsúla den eilimint, le 1 go 3 amharc. Féadfaidh gach comhad a bheith 30.0 MB ar a mhéad, caithfidh sé 300 px ar a laghad a thomhas sa dá thoise, agus caithfidh cóimheas gné idir 0.40 agus 2.50 a bheith aige.
elements[].video_urlroghnach
Cineálurl · video
Léiriú físeáin ar eilimint in áit íomhánna, a mhaireann 3–30 soicind (30.05 soicind ar a mhéad). Ní féidir leis an gcomhad dul thar 300 MB; caithfidh an leithead agus an airde a bheith idir 700–4553 px. Tá cóimheasa gné idir 0.40–2.50 tacaithe, le rátaí fráma 23.9–60.05 FPS.
elements[].voice_idroghnach
Cineálstring | null
Guth sannta don eilimint.
resolutionroghnach
Cineálenum
Réamhshocrú1080p
720p1080p
Taifeach an aschuir.
aspect_ratioroghnach
Cineálenum
Réamhshocrú16:9
auto16:99:161:121:9
Comhréireanna físeáin, roghnaithe go sonrach nó díorthaithe ó na tagairtí trí 'auto' a roghnú.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling/v4/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1175,
    "usd": "1.175",
    "charged": 1175,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
video
object {url, content_type, file_name, file_size}An físeán a tháirg an tsamhail.

Tuilleadh samhlacha: Tagairt go Físeán

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/kling/v4/reference-to-video.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt