ByteDance: Seedance 2.5

Seedance 2.5 мәтіннен және кескін, бейне не аудио референстерден бейне жасайды; өңдеу және жалғастыру жұмыс барысы құжатталған. Оның нақты 2.5 мысалы тауар кескінін бірнеше қозғалыс референсімен біріктіріп, үйлескен жарнамалық реттілік үшін жасалатын дыбысты қосады.

Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-2-5-260628

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

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

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

Кіріс үйлесімдеріне жеке мәтін, міндетті емес мәтінмен бірге берілген кескіндер немесе бейне, дыбысы бар кескіндер, дыбысы бар бейне және кескіндер, бейне мен аудио бірге кіреді. Аталған үйлесімдер тек аудиодан тұратын сұрауды сипаттамай, аудионы визуалды медиамен байланыстырады. Әр элементті рөліне қарай ұйымдастырыңыз: кескін нысанды немесе визуалды көріністі белгілейді, бейне қозғалысты немесе қолда бар көріністі көрсетеді, ал аудио дыбыс референсін береді. Фон референсі басты кейіпкермен шатастырылмауы үшін сұралған планға қай рөл маңызды екенін көрсетіңіз.

Нақты 2.5 мысалы — тауар жарнамасының реттілігі. Ол кескінді және бірнеше бейне референсті беріп, бастапқы назар нүктесін, реттелген тауар композицияларын, бөлшектер көрсетілген кадрларды, баяулатылған әрекетті және соңғы бренд композициясын сипаттайды. Сұрау reference_image және reference_video рөлдерін тағайындап, композиция, қозғалыс, камера жұмысы және әсер үшін жеке референстерді пайдаланады. Бұл науқан тұжырымын құруға қолайлы құрылым береді: көрінетін кезеңдерді жоспарлау, әр кезеңге референсті белгілеу және соңғы орналасуды көрсету.

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

Өңдеу үшін қолда бар бейнені және орта, әрекет немесе визуалды стиль сияқты түзетілетін элементті көрсетіп, бастапқы көрініспен қандай сабақтастық сақталуға тиіс екенін айтыңыз. Жалғастыру үшін берілген бейнематериалдан көрініс қалай жалғасуға тиіс екенін сипаттаңыз. Жаңа бөлікті ғана емес, түйіскен жерін де тексеріңіз: нысанның сыртқы түрі, қозғалыс бағыты, камера орны және дыбыстың уақыттық сәйкестігі нәтижені бір көрініс ретінде қабылдауға әсер етеді. Өзгерістің бастапқы көрініспен қажетті сабақтастықты сақтайтынын тексеру үшін бастапқы бейне мен дайын түзетілген нұсқаны бірге сақтаңыз.

Құжатталған 2.5 мультимодалды мысалы generate_audio=true орнатып, 16:9 кадрлауымен он бес секундтық реттілікті сұрайды. Бұл мәндер әмбебап ұзақтық шегін немесе референс материалдар шектеуін емес, сол мысалды сипаттайды. Музыка, әсерлер және көрінетін әрекет арасындағы байланысты қоса, сұралған көріністе дыбыстың қандай болу керектігін айқын сипаттап, нақты аудиовизуалды нәтижені бағалаңыз. Көзделген темп пен орындалуды тексеру үшін дыбыс референсін және жасалған дыбыс жолын бірге тыңдап бағалау керек.

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

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

Генерация асинхронды жүреді. Жіберу идентификаторды қайтарады, ал бапталған тапсырма барысы күйді, сәтті аяқталғаннан кейін content.video_url береді. Дайын клипті бастапқы медиамен және реттілік тапсырмасымен бірге сақтаңыз. Бүкіл нәтижеде барлық жоспарланған кезеңдерді, заттар әрекеттесуін, кейіпкерлердің сыртқы түрін, кадрлауды және дыбыс сәйкестігін тексеріңіз. Түзету үшін нақты ескерілмей қалған бөлшекті атап, бүкіл тапсырманы байланыссыз нұсқаулармен алмастырмай, көріністің сәтті бөліктерін сақтаңыз.

Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-2-5-260628

doubao-seedance-2-5-260628

ByteDance /doubao-seedance-2-5-260628

Бастау

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

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

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

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

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

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

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

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыcontent, model
Параметр`optional`	Параметр талаптарыgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier
Параметр`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.012 1K бейне токені үшін
БаптауКіріс деректерінде бейне жоқ.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.02 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-5-260628","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-5-260628

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

/v1/videos/generations

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

doubao-seedance-2-5-260628

FAQ · ByteDance: Seedance 2.5

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

ByteDance: Seedance 2.5