שפּרינגען צו אינהאַלט

Seedance 2.5 US Reference to Video

אינטעגרירן

מאָדעל־id bytedance/seedance-2.5/us/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/bytedance/seedance-2.5/us/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"

ביז ⁨$ 6.944⁩ פּער לויפן באַצאָלט לויטן בפועלדיקן באַניץ, דער רעשט ווערט צוריקגעצאָלט לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
ByteDance רעפֿערענץ צו ווידעא געבוירענער אַודיאָרעפֿערענץ־אײַנגאַבעסליפּסינק4–30 sביז 1080p #stylized#transform#lipsync

שאַפֿן, רעדאַקטירן און פֿאַרלענגערן רעפֿערענץ־ווידעאָ מיט Seedance 2.5 פֿון ביז 30 בילדער, 10 ווידעאָס און 10 אַודיאָס

ByteDance · ווידעא

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

טעקסט־פּראָמפּט וואָס פֿירט די ווידעא־גענערירונג.

video_urls
לייגט אַרײַן אַ טעקע, אָדער

צושטעלן ביז 10 רעפֿערענץ־ווידעאָס ווי MP4 אָדער MOV פֿײַלן צו פֿירן די גענערירונג, און אידענטיפיצירן זיי אינעם פּראָמפּט מיט @Video1, @Video2 און ווייטערדיקע געציילטע לאַבעלס. יעדער פֿײַל מוז זײַן נישט גרעסער ווי 200 MB און געדויערן 1.8–30.2 סעקונדעס; אַלע קליפּס צוזאַמען לכל־היותר 30.2 סעקונדעס. נויטיקע ווידעאָ־אייגנשאַפֿטן זענען 24–60 FPS, אַ 0.4–2.5 אַספּעקט־פֿאַרהעלטעניש און 300–6,000 פּיקסעלן אויף יעדער זייט.

duration auto

אויסקלײַב פֿון ווידעאָ־לענג: `auto` איבערלאָזט דעם אויסקלײַב דעם מאָדעל לויטן פּראָמפּט, בשעת אַן אויסדריקליכער געדויער מוז זײַן פֿון 4 ביז 30 סעקונדעס.

resolution סטאַנדאַרט 720p

רעזולטאַט־רעזאָלוציע: 480p פּריאָריטיזירט גיכקייט, 720p גיט באַלאַנס און 1080p גיט הויכע קוואַליטעט.

aspect_ratio סטאַנדאַרט auto

רעזולטאַט־אַספּעקט־פֿאַרהעלטעניש: 16:9 גיט לאַנדשאַפֿט, 9:16 פּאָרטרעט/ווערטיקאַל, 1:1 קוואַדראַט און 21:9 קינעמאַטישע אַלטראַ־ווײַטקייט. אויסקלײַבן `auto` פֿאַר דעם מאָדעל צו אויסקלײַבן דעם פֿאַרהעלטעניש.

פֿאָרגעשריטן images · audios · task · bitrate_mode · codec · end_user_id · seed
image_urls
לייגט אַרײַן אַ טעקע, אָדער

בילד־רעפֿערענצן פֿאַר ווידעאָ־פֿירונג, באַגרענעצט צו 30 בילדער און אונטער אַ מאַקסימום פֿון 50 פֿײַלן איבער אַלע מאָדאַליטעטן. יעדער בילד טאָר זײַן לכל־היותר 30 MB און מוז נוצן JPG, PNG, WebP, BMP, TIFF, GIF, HEIC אָדער HEIF. ניצן @Image1, @Image2 און ווייטערדיקע געציילטע לאַבעלס צו אידענטיפיצירן די רעפֿערענצן אינעם פּראָמפּט.

audio_urls
לייגט אַרײַן אַ טעקע, אָדער

אַודיאָ־רעפֿערענצן פֿאַר ווידעאָ־פֿירונג האָבן אַ געמיינזאַמער געדויער־גרענעץ פֿון 30.2 סעקונדעס איבער ביז 10 פֿײַלן. יעדער מוז נוצן MP3 אָדער WAV, געדויערן 1.8–30.2 סעקונדעס און זײַן לכל־היותר 15 MB. אידענטיפיצירן די פֿײַלן אינעם פּראָמפּט מיט @Audio1, @Audio2 און ווייטערדיקע געציילטע לאַבעלס.

task סטאַנדאַרט reference

ווידעאָ־אַרבעט־אויסקלײַב מיט דרײַ אויפֿפֿירונגען: `reference` פֿירט גענערירונג מיט צוגעשטעלטער מעדיע, editing ענדערט אַ רעפֿערענץ־ווידעא, און extension פֿאַרזעצט איינס. ביידע editing און extension שטעלן אָטאָמאַטיש `aspect_ratio` אויף `auto`; editing שטעלט אויך `duration` אויף `auto`.

bitrate_mode סטאַנדאַרט standard

אויסקלײַבן דעם קאָדירונג־ביטרייט: 'standard' האַלט דעם סטאַנדאַרט, בשעת 'high' בעט דעם מאָדעל פֿאַרבעסערן קאָדירונג־קוואַליטעט אויפֿן חשבון פֿון אַ גרעסערער פֿײַל.

codec סטאַנדאַרט auto

ווידעאָ־קאָדעק־אויסקלײַב: `auto` לאָזט דעם סטאַנדאַרט־קאָדעק־אָפּפֿירונג אומגעענדערט, `H264` אויסקלײַבט H.264 און `H265` אויסקלײַבט H.265.

איינציקער אידענטיפיצירער צוגעטיילט דעם ענד־באַניצער.

צופֿעליקער seed געניצט צו מאַכן גענערירונג רעפּראָדוצירבאַר, אָן גאַראַנטירן גענויע איבערחזרונג: ווידערניצן אים קען נאָך געבן אַ ביסל אַנדערע רעזולטאַטן.

POST /run/bytedance/seedance-2.5/us/reference-to-video?wait=20 פּרײַז → ⁨$ 6.944⁩
# 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/bytedance/seedance-2.5/us/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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Seedance 2.5 US Reference to Video

די באַשטעטיקונג `task` וועקסלט צווישן רעפֿערענץ־געפֿירטע שאַפונג, רעדאַקטירן אַ רעפֿערענץ־ווידעאָ און פֿאַרלענגערן איינעם. נעמט אָן ביז 30 בילדער, 10 ווידעאָס און 10 אַודיאָ־טעקעס ווי רעפֿערענצן, ציטירט ווי @Image1 און ענלעכע. גיט אַרויס 480p, 720p אָדער 1080p, אויטאָמאַטיש אָדער פֿאַר 4 ביז 30 סעקונדעס, מיט אַספּעקט־פֿאַרהעלטענישן פֿון 21:9 ביז 9:16. שטיצט `seed` און `bitrate_mode`.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptאָפּציאָנעל
טיפּstring | null
טעקסט־פּראָמפּט וואָס פֿירט די ווידעא־גענערירונג.
taskאָפּציאָנעל
טיפּenum
סטאַנדאַרטreference
referenceeditingextension
ווידעאָ־אַרבעט־אויסקלײַב מיט דרײַ אויפֿפֿירונגען: `reference` פֿירט גענערירונג מיט צוגעשטעלטער מעדיע, editing ענדערט אַ רעפֿערענץ־ווידעא, און extension פֿאַרזעצט איינס. ביידע editing און extension שטעלן אָטאָמאַטיש `aspect_ratio` אויף `auto`; editing שטעלט אויך `duration` אויף `auto`.
image_urlsאָפּציאָנעל images
טיפּurl[] · image
בילד־רעפֿערענצן פֿאַר ווידעאָ־פֿירונג, באַגרענעצט צו 30 בילדער און אונטער אַ מאַקסימום פֿון 50 פֿײַלן איבער אַלע מאָדאַליטעטן. יעדער בילד טאָר זײַן לכל־היותר 30 MB און מוז נוצן JPG, PNG, WebP, BMP, TIFF, GIF, HEIC אָדער HEIF. ניצן @Image1, @Image2 און ווייטערדיקע געציילטע לאַבעלס צו אידענטיפיצירן די רעפֿערענצן אינעם פּראָמפּט.
video_urlsאָפּציאָנעל videos
טיפּurl[] · video
צושטעלן ביז 10 רעפֿערענץ־ווידעאָס ווי MP4 אָדער MOV פֿײַלן צו פֿירן די גענערירונג, און אידענטיפיצירן זיי אינעם פּראָמפּט מיט @Video1, @Video2 און ווייטערדיקע געציילטע לאַבעלס. יעדער פֿײַל מוז זײַן נישט גרעסער ווי 200 MB און געדויערן 1.8–30.2 סעקונדעס; אַלע קליפּס צוזאַמען לכל־היותר 30.2 סעקונדעס. נויטיקע ווידעאָ־אייגנשאַפֿטן זענען 24–60 FPS, אַ 0.4–2.5 אַספּעקט־פֿאַרהעלטעניש און 300–6,000 פּיקסעלן אויף יעדער זייט.
audio_urlsאָפּציאָנעל audios
טיפּurl[] · audio
אַודיאָ־רעפֿערענצן פֿאַר ווידעאָ־פֿירונג האָבן אַ געמיינזאַמער געדויער־גרענעץ פֿון 30.2 סעקונדעס איבער ביז 10 פֿײַלן. יעדער מוז נוצן MP3 אָדער WAV, געדויערן 1.8–30.2 סעקונדעס און זײַן לכל־היותר 15 MB. אידענטיפיצירן די פֿײַלן אינעם פּראָמפּט מיט @Audio1, @Audio2 און ווייטערדיקע געציילטע לאַבעלס.
resolutionאָפּציאָנעל
טיפּenum
סטאַנדאַרט720p
480p720p1080p
רעזולטאַט־רעזאָלוציע: 480p פּריאָריטיזירט גיכקייט, 720p גיט באַלאַנס און 1080p גיט הויכע קוואַליטעט.
durationאָפּציאָנעל
טיפּenum
סטאַנדאַרטauto
auto456789101112131415161718
+12 נאָך192021222324252627282930
אויסקלײַב פֿון ווידעאָ־לענג: `auto` איבערלאָזט דעם אויסקלײַב דעם מאָדעל לויטן פּראָמפּט, בשעת אַן אויסדריקליכער געדויער מוז זײַן פֿון 4 ביז 30 סעקונדעס.
aspect_ratioאָפּציאָנעל
טיפּenum
סטאַנדאַרטauto
auto21:916:94:31:13:49:16
רעזולטאַט־אַספּעקט־פֿאַרהעלטעניש: 16:9 גיט לאַנדשאַפֿט, 9:16 פּאָרטרעט/ווערטיקאַל, 1:1 קוואַדראַט און 21:9 קינעמאַטישע אַלטראַ־ווײַטקייט. אויסקלײַבן `auto` פֿאַר דעם מאָדעל צו אויסקלײַבן דעם פֿאַרהעלטעניש.
generate_audioאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיוויזירט דאָס צו באַגלייטן די ווידעא מיט סינכראָניזירטן אַודיאָ. דער גענערירטער אַודיאָ נעמט אַרײַן רעדע צוגעפּאַסט צו ליפּ־באַוועגונגען, סביבה־אַטמאָספֿערע און קלאַנג־עפֿעקטן.
bitrate_modeאָפּציאָנעל
טיפּenum
סטאַנדאַרטstandard
standardhigh
אויסקלײַבן דעם קאָדירונג־ביטרייט: 'standard' האַלט דעם סטאַנדאַרט, בשעת 'high' בעט דעם מאָדעל פֿאַרבעסערן קאָדירונג־קוואַליטעט אויפֿן חשבון פֿון אַ גרעסערער פֿײַל.
codecאָפּציאָנעל
טיפּenum
סטאַנדאַרטauto
autoH264H265
ווידעאָ־קאָדעק־אויסקלײַב: `auto` לאָזט דעם סטאַנדאַרט־קאָדעק־אָפּפֿירונג אומגעענדערט, `H264` אויסקלײַבט H.264 און `H265` אויסקלײַבט H.265.
seedאָפּציאָנעל
טיפּinteger | null
צופֿעליקער seed געניצט צו מאַכן גענערירונג רעפּראָדוצירבאַר, אָן גאַראַנטירן גענויע איבערחזרונג: ווידערניצן אים קען נאָך געבן אַ ביסל אַנדערע רעזולטאַטן.
end_user_idאָפּציאָנעל
טיפּstring | null
איינציקער אידענטיפיצירער צוגעטיילט דעם ענד־באַניצער.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bytedance/seedance-2.5/us/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": 6944,
    "usd": "6.944",
    "charged": 6944,
    "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
    },
    "seed": 42,
    "draft_id": "string"
  },
  "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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
video
object {url, content_type, file_name, file_size}ווידעא־פֿײַל געשאַפֿן דורך גענערירונג.
seed
integerסיד־ווערט וואָס ווערט געווענדט בעת גענערירונג.
draft_id
string | nullדראַפט־אידענטיפיצירער פֿאַר פֿאַרענדיקונג אונטער דעם זעלבן חשבון אין זיבן טעג; דער ענטפֿער אַנטהאַלט אַנשטאָט null ווען דראַפט־מאָדע איז אויסגעלאָשן.

מער מאָדעלן: רעפֿערענץ צו ווידעא

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/bytedance/seedance-2.5/us/reference-to-video.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt