Léim chuig an ábhar

ID-V2V

Comhtháthú

Aitheantas na samhla id-v2v
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/id-v2v?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",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

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

Faigh eochair API
Open model Físeán go Físeán suas le 720p #stylized#transform#editing

Athstílíonn sé físeán ó chéadfhráma athstílithe agus coinníonn sé céannacht agus gluaiseacht an ábhair

Open model · 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.

•riachtanach

Leid ina sonraítear an físeán athstílithe atá inmhianaithe.

•riachtanach video_url
Scaoil comhad, nó

Tagairt gluaisne agus frámaithe don ghiniúint, soláthraithe mar URL an fhíseáin foinse.

•riachtanach image_url
Scaoil comhad, nó

Tagairt aitheantais agus stíle d’athghiniúint físeáin, soláthraithe mar URL a dhíríonn ar an gcéad fhráma athstílithe.

resolution réamhshocrú 720p

Roghnaigh 720p le haghaidh aschur 1280×720 nó 720×1280, nó 480p le haghaidh aschur 832×480 nó 480×832. Cinneann treoshuíomh an fhíseáin foinse cé na toisí a chuirtear i bhfeidhm.

réamhshocrú 81

Teorannaigh líon na bhfrámaí atá le táirgeadh; má tá níos lú frámaí san fhoinse, is é a líon frámaí an teorainn uachtarach.

Ardleibhéal segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

Leid roghnúcháin ábhair do SAM-3, lena sainaithnítear an réigiún a threoróidh a phicteilíní an ghiniúint. Lasmuigh den ábhar deighilte sin, níl srian leis an nginiúint.

réamhshocrú 30

Rialú ar cháilíocht agus luas an ghearrthóga, léirithe mar líon céimeanna samplála díraonta do gach gearrthóg: feabhsaíonn níos mó céimeanna an cháilíocht ach tógann siad níos mó ama.

réamhshocrú 5

Neart treorach saor ó aicmitheoir, a chothromaíonn cloí leis an leid agus cruthaitheacht.

réamhshocrú 1

Cloí struchtúrach leis an bhfíseán foinse, coigeartaithe tríd an scála riochtaithe VACE.

Síol randamach comhroinnte idir gach gearrthóg agus gearrthóga iolracha á nginiúint, rud a cheadaíonn giniúint in-atáirgthe.

Ancairí aitheantais roghnacha d’fhíseáin fhada: soláthair eochairfhrámaí athstílithe leis na hinnéacsanna fráma aschuir ag a gcaithfidh siad a bheith le feiceáil.

POST /run/id-v2v?wait=20 luachan → $1.013
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/id-v2v?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",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 ID-V2V

Athghineann sé físeán foinse (`video_url`) i gcuma chéadfhráma athstílithe (`image_url`) faoi threoir `prompt`. Is féidir le suas le 5 `keyframes` céannacht a dhaingniú i ngearrthóga níos faide. Is é an t-aschur 480p nó 720p le `num_frames` ó 17 go 241, agus roghnaíonn `segmentation_prompt` (person de réir réamhshocraithe) an t-ábhar a mbíonn a phicteilíní mar choinníoll don toradh.

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
promptriachtanach
Cineálstring
Leid ina sonraítear an físeán athstílithe atá inmhianaithe.
video_urlriachtanach video
Cineálurl · video
Tagairt gluaisne agus frámaithe don ghiniúint, soláthraithe mar URL an fhíseáin foinse.
image_urlriachtanach image
Cineálurl · image
Tagairt aitheantais agus stíle d’athghiniúint físeáin, soláthraithe mar URL a dhíríonn ar an gcéad fhráma athstílithe.
keyframesroghnach
Cineálobject[]
≤ 5 mhír
Ancairí aitheantais roghnacha d’fhíseáin fhada: soláthair eochairfhrámaí athstílithe leis na hinnéacsanna fráma aschuir ag a gcaithfidh siad a bheith le feiceáil.
keyframes[].image_urlriachtanach
Cineálurl · image
URL íomhá athstílithe le haghaidh ancaire aitheantais i bhfíseán fada; ní mór do chóimheas gné na híomhá a bheith laistigh de 0.1 ó chóimheas gné an aschuir. Bíonn an íomhá le feiceáil gan athrú ag `frame_index`.
keyframes[].frame_indexriachtanach
Cineálinteger
≥ 1
Cuir an eochairfhráma ag suíomh aschuir 1 ar a laghad agus faoi bhun líon iomlán frámaí an aschuir, ag úsáid innéacsú bunaithe ar 0. Tá suíomh 0 curtha in áirithe don fhráma tosaigh athstílithe ó `image_url`.
resolutionroghnach
Cineálenum
Réamhshocrú720p
480p720p
Roghnaigh 720p le haghaidh aschur 1280×720 nó 720×1280, nó 480p le haghaidh aschur 832×480 nó 480×832. Cinneann treoshuíomh an fhíseáin foinse cé na toisí a chuirtear i bhfeidhm.
num_framesroghnach
Cineálinteger
Réamhshocrú81
17 – 241
Teorannaigh líon na bhfrámaí atá le táirgeadh; má tá níos lú frámaí san fhoinse, is é a líon frámaí an teorainn uachtarach.
segmentation_promptroghnach
Cineálstring
Réamhshocrúperson
≤ 100 gcarachtar
Leid roghnúcháin ábhair do SAM-3, lena sainaithnítear an réigiún a threoróidh a phicteilíní an ghiniúint. Lasmuigh den ábhar deighilte sin, níl srian leis an nginiúint.
num_inference_stepsroghnach
Cineálinteger
Réamhshocrú30
2 – 40
Rialú ar cháilíocht agus luas an ghearrthóga, léirithe mar líon céimeanna samplála díraonta do gach gearrthóg: feabhsaíonn níos mó céimeanna an cháilíocht ach tógann siad níos mó ama.
guidance_scaleroghnach
Cineálnumber
Réamhshocrú5
1 – 10
Neart treorach saor ó aicmitheoir, a chothromaíonn cloí leis an leid agus cruthaitheacht.
vace_scaleroghnach
Cineálnumber
Réamhshocrú1
0 – 2
Cloí struchtúrach leis an bhfíseán foinse, coigeartaithe tríd an scála riochtaithe VACE.
seedroghnach
Cineálinteger | null
Síol randamach comhroinnte idir gach gearrthóg agus gearrthóga iolracha á nginiúint, rud a cheadaíonn giniúint in-atáirgthe.
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrútrue
Cumasaíonn sé seiceálacha sábháilteachta ar ionchuir agus aschuir araon.
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": "id-v2v",
  "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": 1013,
    "usd": "1.013",
    "charged": 1013,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
    },
    "seed": 42
  },
  "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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}Comhad físeáin a tháirgtear leis an nginiúint.
seed
integerLuach síl a chuirtear i bhfeidhm le linn giniúna.

Tuilleadh samhlacha: Físeán go Físeán

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