Léim chuig an ábhar

Editto

Comhtháthú

Aitheantas na samhla editto
# 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/editto?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"
  }'

# 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: $0.405 405 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 #video-edit#wan-vace

Eagarthóireacht físeán bunaithe ar threoracha a athscríobhann físeán foinse ó leid, le rialuithe frámaí, fps agus rúin

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

Treoracha téacs a threoraíonn giniúint físeáin.

•riachtanach video_url
Scaoil comhad, nó

URL an chomhaid físe foinseach; riachtanach agus inpainting á dhéanamh.

resolution réamhshocrú auto

Taifeach an fhíseáin aschuir.

aspect_ratio réamhshocrú auto

Cóimheas gné an fhíseáin deiridh.

réamhshocrú 81

Líon frámaí aschuir, le raon cuimsitheach 81–241.

réamhshocrú 0

Líon idirshuíomh: fágann 0 na frámaí bunaidh gan idirshuíomh; sonraíonn luachanna eile cé mhéad fráma idirmheánach atá le giniúint eatarthu.

Ardleibhéal negative_prompt · sampler · acceleration · video_quality · video_write_mode · frames_per_second · num_inference_steps · guidance_scale · shift · temporal_downsample_factor · seed · match_input_frames_per_second · enable_safety_checker · enable_auto_downsample · return_frames_zip
réamhshocrú letterboxing, borders...

Leid dhiúltach a chuirtear i bhfeidhm agus físeán á ghiniúint.

sampler réamhshocrú unipc

Samplálaí a úsáidtear agus an físeán á ghiniúint.

acceleration réamhshocrú regular

Socrú luasghéaraithe tátail, le rogha idir 'none' agus 'regular': soláthraíonn próiseáil luathaithe feabhas suntasach ar luas ar chostas athrú an-bheag san aschur.

video_quality réamhshocrú high

Leibhéal cáilíochta an fhíseáin a bheidh mar thoradh air.

video_write_mode réamhshocrú balanced

Mód scríofa an fhíseáin a bheidh mar thoradh air.

réamhshocrú 16

Ráta fráma an fhíseáin ghinte, curtha i bhfeidhm nuair nach bhfuil `match_input_frames_per_second` true; luachanna glactha: 5–30 fráma in aghaidh an tsoicind.

réamhshocrú 30

Líon na gcéimeanna samplála, áit a mhalartaítear am próiseála níos faide ar cháilíocht níos fearr de réir mar a mhéadaíonn an líon.

réamhshocrú 5

Neart ailínithe na leide, rialaithe trí threoir saor ó aicmitheoir; spreagann an scála a mhéadú na híomhánna ginte chun an téacs a leanúint níos dlúithe.

réamhshocrú 5

Socrú aistrithe a chuirtear i bhfeidhm agus an físeán á ghiniúint.

réamhshocrú 0

Fachtóir scipeála frámaí físeáin, sainráite mar shlánuimhir, agus uas-shampláil uathoibríoch curtha i bhfeidhm uair amháin do gach fachtóir íos-samplála. Úsáid 0 chun íos-sampláil ama a fhágáil díchumasaithe.

Síol a fhágann giniúint in-atáirgthe. Má shocraítear é go None, roghnaítear síol go randamach.

POST /run/editto?wait=20 luachan → $0.405
# 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/editto?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"
  }'

# 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 Editto

Cuirtear físeán atá ann cheana, tugtha ag `video_url`, in eagar faoi threoir `prompt` téacs. Is féidir leis an aschur líon frámaí agus ráta fráma an ionchuir a leanúint, nó `num_frames` (17 go 241) agus `frames_per_second` (5 go 30) a úsáid. Téann an taifeach ó 240p go 720p, is féidir an cóimheas gné a bheith auto, 16:9, 1:1 nó 9:16, agus is féidir ZIP de na frámaí a thabhairt ar ais freisin.

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
Treoracha téacs a threoraíonn giniúint físeáin.
negative_promptroghnach
Cineálstring
Réamhshocrúletterboxing, borders, black bars, bright colors, overexposed, static, blurred details, subtitles, style, artwork, painting, picture, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, malformed limbs, fused fingers, still picture, cluttered background, three legs, many people in the background, walking backwards
Leid dhiúltach a chuirtear i bhfeidhm agus físeán á ghiniúint.
match_input_num_framesroghnach
Cineálboolean
Réamhshocrúfalse
Foinse líon frámaí an fhíseáin ghinte: úsáideann false `num_frames`, agus cóipeálann true líon frámaí an fhíseáin ionchuir.
num_framesroghnach
Cineálinteger
Réamhshocrú81
17 – 241
Líon frámaí aschuir, le raon cuimsitheach 81–241.
match_input_frames_per_secondroghnach
Cineálboolean
Réamhshocrúfalse
Foinse ráta fráma an fhíseáin ghinte: úsáideann false `frames_per_second`, agus cóipeálann true ráta fráma an fhíseáin ionchuir.
frames_per_secondroghnach
Cineálinteger | null
Réamhshocrú16
5 – 30
Ráta fráma an fhíseáin ghinte, curtha i bhfeidhm nuair nach bhfuil `match_input_frames_per_second` true; luachanna glactha: 5–30 fráma in aghaidh an tsoicind.
seedroghnach
Cineálinteger | null
Síol a fhágann giniúint in-atáirgthe. Má shocraítear é go None, roghnaítear síol go randamach.
resolutionroghnach
Cineálenum
Réamhshocrúauto
auto240p360p480p580p720p
Taifeach an fhíseáin aschuir.
aspect_ratioroghnach
Cineálenum
Réamhshocrúauto
auto16:91:19:16
Cóimheas gné an fhíseáin deiridh.
num_inference_stepsroghnach
Cineálinteger
Réamhshocrú30
2 – 50
Líon na gcéimeanna samplála, áit a mhalartaítear am próiseála níos faide ar cháilíocht níos fearr de réir mar a mhéadaíonn an líon.
guidance_scaleroghnach
Cineálnumber
Réamhshocrú5
1 – 10
Neart ailínithe na leide, rialaithe trí threoir saor ó aicmitheoir; spreagann an scála a mhéadú na híomhánna ginte chun an téacs a leanúint níos dlúithe.
samplerroghnach
Cineálenum
Réamhshocrúunipc
unipcdpm++euler
Samplálaí a úsáidtear agus an físeán á ghiniúint.
shiftroghnach
Cineálnumber
Réamhshocrú5
1 – 15
Socrú aistrithe a chuirtear i bhfeidhm agus an físeán á ghiniúint.
video_urlriachtanach video
Cineálurl · video
URL an chomhaid físe foinseach; riachtanach agus inpainting á dhéanamh.
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrúfalse
Lascthrealamh seiceála sábháilteachta a éilíonn údarú cuntais nuair atá sé múchta. Gan an t-údarú sin, seiceáiltear gach iarratas beag beann ar an socrú; cumasaíonn true an seiceálaí.
accelerationroghnach
Cineálenum
Réamhshocrúregular
nonelowregular
Socrú luasghéaraithe tátail, le rogha idir 'none' agus 'regular': soláthraíonn próiseáil luathaithe feabhas suntasach ar luas ar chostas athrú an-bheag san aschur.
video_qualityroghnach
Cineálenum
Réamhshocrúhigh
lowmediumhighmaximum
Leibhéal cáilíochta an fhíseáin a bheidh mar thoradh air.
video_write_moderoghnach
Cineálenum
Réamhshocrúbalanced
fastbalancedsmall
Mód scríofa an fhíseáin a bheidh mar thoradh air.
num_interpolated_framesroghnach
Cineálinteger
Réamhshocrú0
0 – 5
Líon idirshuíomh: fágann 0 na frámaí bunaidh gan idirshuíomh; sonraíonn luachanna eile cé mhéad fráma idirmheánach atá le giniúint eatarthu.
temporal_downsample_factorroghnach
Cineálinteger
Réamhshocrú0
0 – 5
Fachtóir scipeála frámaí físeáin, sainráite mar shlánuimhir, agus uas-shampláil uathoibríoch curtha i bhfeidhm uair amháin do gach fachtóir íos-samplála. Úsáid 0 chun íos-sampláil ama a fhágáil díchumasaithe.
enable_auto_downsampleroghnach
Cineálboolean
Réamhshocrúfalse
Oiriúnú uathoibríoch do líon na bhfrámaí: ligeann é a chumasú don tsamhail físeán atá íos-sampláilte ó thaobh ama de agus fad oiriúnach aige a phróiseáil, agus athbhunaíonn idirshuíomh ina dhiaidh sin an líon frámaí bunaidh.
return_frames_ziproghnach
Cineálboolean
Réamhshocrúfalse
Rialaíonn sé an gcuirtear cartlann ZIP ina bhfuil gach fráma ginte ar ais freisin; cumasaithe nuair atá true.
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": "editto",
  "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": 405,
    "usd": "0.405",
    "charged": 405,
    "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"
  },
  "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,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "prompt": "Make it a Pixel Art video.",
    "seed": 42,
    "frames_zip": {
      "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://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, width, height, fps, duration, num_frames}Comhad físe ginte ón íomhá.
prompt
stringLeid a úsáideadh chun an t-aschur a ghiniúint.
seed
integerLuach síl a chuirtear i bhfeidhm le linn giniúna.
frames_zip
object {url, content_type, file_name, file_size} | nullCartlann ZIP ina bhfuil gach fráma físe, curtha ar ais nuair a iarrtar é.

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