ByteDance: Seedance 2.0

Seedance 2.0 мәтінді, кескіндерді, бейне және аудио референстерді пайдаланып бейне жасайды әрі өңдейді. Ол қолда бар бейнематериалды жалғастырып, синхрондалған дыбыс жасай алады; ұзақтығы 4–15 секунд, шығысы 480p немесе 720p және референс рөлдері айқын көрсетіледі.

Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-2-0-260128

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Seedance 2.0 жазбаша көріністен немесе кескін, бейне және аудио референстердің үйлесімінен бейне жасайды. Нақты doubao-seedance-2-0-260128 селекторы стандартты 2.0 профилін анықтайды. Құжатталған жұмыс барысына жаңа бейне генерациялау, қолда бар материалды өңдеу және жалғастыру кіреді. Референстермен сыртқы түрді, қозғалысты, операторлық тәсілдерді және дыбысты жеткізіп, көріністің қай бөлігін басқаруға тиіс екенін айтыңыз.

Мәтінді жеке беруге болады. Құжатталған мультимодалды үйлесімдер кескіндерді не бейнені міндетті емес мәтінмен бірге, дыбысы бар кескіндерді, дыбысы бар бейнені және кескіндерді, бейне мен дыбысты бірге де қабылдайды. Демек, аталған үйлесімдерде аудио визуалды материалмен бірге беріледі; ол жеке аудиодан бейне жасау сұрауы ретінде сипатталмаған. Мәтін міндетті емес жерде де әр референстің рөлі байланыссыз материалдардан болжанбай, айқын болуы үшін қажетті нәтижені анық жазыңыз.

content массиві text, image_url, video_url және audio_url элементтерін ажыратады. Мультимодалды референстер reference_image, reference_video және reference_audio сияқты рөлдерді пайдаланады. Кескін адамды, затты, орынды немесе визуалды көріністі белгілей алады. Бейне орындауды, қозғалысты немесе камера ракурсын көрсете алады, ал аудио дыбыс жолын немесе уақыттық өрнекті белгілейді. Міндеттерді тапсырмада айтыңыз: кескіндегі нысанды сақтау, бейненің камера ракурсына еру және аудионы фон ретінде пайдалану. Әр референстен барлық қасиетті бірден анықтауды сұрамаңыз.

Құжатталған жарнама мысалы екі тауар кескінін бейне және аудио референспен біріктіреді. Ол фондық дауысты біркелкі сақтай отырып, бастапқы көріністі, әрекет ретін, тауар бөлшегінің жақыннан көрсетілуін және соңғы композицияны сипаттайды. Сол құрылым қысқа таныстырылымды ұйымдастыра алады: затты көрсету, бір әрекетті көрсету және танылатын ерекшелігімен аяқтау. Өңдеу үшін бастапқы бейнематериалды және өзгеруге тиіс элементті көрсетіңіз; жалғастыру үшін нысан мен қозғалыс бағытын сақтай отырып, қолда бар көріністен кейін жалғасатын әрекетті түсіндіріңіз.

2.0 профилінің құжаттамасында төрттен он беске дейінгі бүтін секундтар немесе сол диапазонда ұзақтықты автоматты таңдау үшін -1 мәні көрсетілген. Әдепкісі — бес секунд. Ажыратымдылық нұсқалары 480p және 720p, әдепкісі — 720p; 2.0 үшін 1080p алынып тасталған. Тұрақты арақатынастар: 16:9, 4:3, 1:1, 3:4, 9:16 және 21:9. Бейімделмелі арақатынас кадрлауды мәтіннен немесе референстен таңдай алады: бірінші кадрмен жұмыс бастапқы кескінге ереді, ал мультимодалды жұмыс көзделген көріністі немесе алғашқы тиісті медианы пайдаланады, мұнда бейне кескіннен басым. Нақты арақатынас пен ұзақтықты тапсырма нәтижесінен тексеріңіз.

Жасалатын дыбыс референс медиадан бөлек басқарылады. generate_audio=true мәтін мен визуалды мазмұнға сүйеніп синхрондалған дауыстарды, әсерлерді және фондық музыканы сұрайды; false дыбыссыз бейнені сұрайды. Құжатталған әдепкі мән — true, сөйлеу үшін диалогті тырнақшаға алу ұсынылады. Кім сөйлейтінін және дыбыстың көрінетін әрекетпен қалай байланысатынын көрсетіп, нақты сөздерді, дауыстардың тиесілігін және уақыттық сәйкестікті тексеріңіз. Аудио референсті беру және дыбыс генерациясын қосу — сұраудың бөлек таңдаулары.

2.0 нұсқаулығы ескі frames және camera_fixed басқаруларын алып тастайды әрі flex offline өңдеуін қолдамайды. duration өрісін пайдаланып, камера қозғалысын көріністің өзінде сипаттаңыз. Бастапқы мән және сутаңба құжатталған басқарулар болып қалады; нұсқаулық бірдей сұрау мен seed ұқсас нәтиже беруі мүмкін екенін айтады, бірақ дәл сәйкестікке кепілдік бермейді. seed мәнін нәтижені дәл қайталауға болатынының дәлелі немесе қайталанған сұрауды тексеріліп қойған клип деп қабылдамаңыз.

Бейнетокен шығыны былай есептеледі: (кіріс бейне ұзақтығы + шығыс бейне ұзақтығы) × шығыс ені × шығыс биіктігі × шығыс кадр жиілігі / 1024. Кіріс бейнесі бар және жоқ сұраулар бөлек төлем санаттарына жатады. Тапсырма сұрауы usage.completion_tokens және usage.total_tokens мәндерін хабарлайды; осы хабарланған мөлшерлерді дайын клиппен бірге сақтаңыз.

Жұмыс барысы асинхронды: жіберу тапсырма идентификаторын қайтарады, ал аяқталған тапсырма content.video_url мекенжайын хабарланған ұзақтық, ажыратымдылық, арақатынас, кадр жиілігі және токен шығынымен бірге береді. Идентификаторды сақтап, дайын бейнені бастапқы референстермен және мәтіндік сұраумен бірге сақтаңыз. Жарамдылық өрісінің әдепкісі — 172800 секунд, тапсырма жасалған сәттен 3600–259200 секунд қабылдайды; аралықтан асқан тапсырма expired күйіне өтеді. Өңдеу немесе жалғастыру түйіскен жерін қоса бүкіл нәтижедегі кейіпкердің сыртқы түрін, зат бөлшектерін, кеңістіктік қатынастарды, камера қозғалысының сабақтастығын және дыбыстың суретке уақыттық сәйкестігін тексеріңіз.

Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-2-0-260128

doubao-seedance-2-0-260128

ByteDance /doubao-seedance-2-0-260128

Бастау

Қабылданатын кіріс деректері: Мәтін · Суреттер · Бейне · Аудио
Нәтижелер: Бейне

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Бейне POST /v1/videos

Кіріс: text, image, video, audio
Шығыс: video

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер doubao-seedance-2-0-260128	Әдепкі—
Өріс`content`	Түрі`array`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Төл пішімдегі мәтін немесе медиа объектілері; сыртқы массив бос болмауы керек. Бұл әмбебап Ailoot құрастырушысы ішкі түйіндердің түрлерін тексермейді.	Әдепкі—
Өріс`generate_audio`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Бейнеге кірістірілген синхрондалған дыбыс.	Әдепкіtrue
Өріс`duration`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: 4–15 аралығындағы бүтін сан немесе -1; нақты шығыс ұзақтығы қайтарылады.	Әдепкі5
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 480p, 720p Шарттар: 2.0/fast үшін 1080p қолдау көрсетілмейтіні нақты жазылған.	Әдепкі720p
Өріс`ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Шарттар: Бейімделетін режим тек 2.0/fast/1.5 үшін нақты көрсетілген; 2.5 мысалында тек 16:9 берілген.	Әдепкіadaptive
Өріс`watermark`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкіfalse
Өріс`seed`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: -1 Ең көбі: 4 294 967 295	Әдепкі-1
Өріс`execution_expires_after`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 3 600 Ең көбі: 259 200 Бірлік: секунд	Әдепкі172 800
Өріс`service_tier`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер default Шарттар: 2.0/fast үшін желіден тыс flex режиміне жол берілмейді; 2.5 үшін қолданылу аясы анықталмаған.	Әдепкіdefault
Өріс`safety_identifier`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—
Өріс`tools`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Тек 2.0/fast үшін; құжатталған мән — type=web_search.	Әдепкі—

Кіріс материалдарының үйлесімдері

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыcontent, model
Параметр`optional`	Параметр талаптарыgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier, tools
Параметр`material_types`	Параметр талаптарыtext, image, video, audio
Параметр`additional_properties`	Параметр талаптарыtrue
Параметр`validation_scope`	Параметр талаптарыAiloot міндетті өрістердің түрлерін және model/content массивінің бос еместігін тексереді. Сұраудың басқа өрістері таңдалған модель үшін сақталады.
Параметр`material_combinations`	Параметр талаптарыtext, image, video, image, audio, image, video, video, audio, image, video, audio
Параметр`optional_text_with_media`	Параметр талаптарыtrue
Параметр`reference_media_count_and_size_limits`	Параметр талаптарыnull

Әдістің балама атаулары: /v1/videos/generations

Өмірлік цикл: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Бір рет жасаңыз және қайтарылған ашық id/polling_url мәндерін сақтаңыз.

Бастапқы тапсырманың күйін мезгіл-мезгіл сұраңыз; succeeded күйінен кейін иелігіңіздегі нақты content.video_url бойынша файлды жүктеп алыңыз.

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Есептеу бірлігі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Есептеу бірлігі—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауКіріс деректерінде бейне бар.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.0096 1K бейне токені үшін
БаптауКіріс деректерінде бейне жоқ.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.015768 1K бейне токені үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.822402 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Бейне

curl · бейне құрыңызcurl · бастапқы тапсырманы оқыңызcurl · өзіңізге тиесілі бейнені жүктеп алыңыз

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-2-0-260128","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}]}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
    if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
    p=urlsplit(u)
    if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
  index=$((index + 1))
done < asset-urls.txt

Нәтижелерді алу және сақтау

Ailoot Ultra · Бейне

Ашық id/polling_url бар төл JSON. Жарияланғаннан кейін content.video_url ішінде Ailoot иелігіндегі қолтаңбасы бар URL мекенжайлары болады; жарияланғанға дейін таңдалған шығыс URL мекенжайлары босатылады.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Барлық дайын нәтижені сақтау

Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.

content.video_url ішіндегі әрбір нақты URL мәнін сақтаңыз; index нақты қайтарылған шығыс нәтижесін көрсетуі керек.

Бастапқы жауапты тексеру қажет болса

Бастапқы жауапты, тақырыптарды және id мәнін сақтап, сол операцияның күйін мезгіл-мезгіл сұраңыз; нәтижесі белгісіз жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`id`	Түріstring
Өріс`provider_task_id`	Түріstring
Өріс`polling_url`	Түріstring
Өріс`status`	Түріstring when supplied
Өріс`content.video_url`	Түріstring\|string[]
Өріс`usage`	Түріobject when supplied

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартJSON, модель, міндетті өрістердің түрлері немесе мазмұн индексі жарамсыз.	Келесі қадам
Жауап401 · `authentication_error`	ШартAiloot API кілті жарамсыз.	Келесі қадам
Жауап404 · `not_found_error`	ШартТапсырма немесе шығыс нәтижесі жоқ не сол пайдаланушыға, API кілтіне немесе топқа тиесілі емес.	Келесі қадам
Жауап502 · `result_pending_check`	ШартБастапқы жіберу немесе күй мәліметі толық емес; бастапқы ID мәнін сақтап, қайта жібермеңіз.	Келесі қадам
Жауап503 · `result_pending_check`	ШартБастапқы медиа, маршрут немесе есеп айырысу тексерілуде; бастапқы операцияны жалғастырыңыз.	Келесі қадам

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra doubao-seedance-2-0-260128

Әдіс жолдарының балама атаулары

/v1/videos/generations

Шақыруға арналған байланысты ID

doubao-seedance-2-0-260128

FAQ · ByteDance: Seedance 2.0

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/videos · doubao-seedance-2-0-260128: text, image, video, audio → video
Сұрау қандай өрістерді пайдаланады?: POST /v1/videos · doubao-seedance-2-0-260128: model, content, generate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier, tools
Қандай шектеулер қолданылады?: POST /v1/videos · doubao-seedance-2-0-260128: seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 2.0