ByteDance: Seedance 1.5 Pro

Seedance 1.5 Pro мәтіннен немесе кескіннен бейне жасайды және синхрондалған дауыстарды, әсерлерді, фондық музыканы жасай алады. Дыбысты қосуға не өшіруге болады; құжатталған профиль 4–12 секундтық көріністерді, бейімделмелі кадрлауды және online немесе flex өңдеуін ұсынады.

Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-1-5-pro-251215

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

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

Seedance 1.5 Pro мәтіннен немесе кескіннен бейне жасайды және дыбысты суретпен бірге генерациялай алады. Нақты селектор — doubao-seedance-1-5-pro-251215. Дыбыс параметрі оны дыбыссыз Seedance 1.0 профильдерінен ерекшелейді: generate_audio=true синхрондалған дыбысты, ал false дыбыссыз бейнені сұрайды. Жаңа тұжырым үшін жазбаша көріністі, ал бастапқы нысан мен композицияны белгілеу үшін кескінді пайдаланыңыз.

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

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

Кескіннен бейне жасау мәтінмен бірге image_url элементін пайдаланады. Қолжетімді кескін URL мекенжайын немесе JPEG, PNG, WEBP, BMP, TIFF не GIF пішіміндегі Base64 data URL беріңіз. Құжатталған кескін шектері: 30 MB-тан аз, екі өлшемі қатаң түрде 300 бен 6000 пиксель арасында, енінің биіктігіне қатынасы қатаң түрде 0.4 пен 2.5 арасында. Қажетті кадрлауды және нысанды анық дайындап, сол композициядан басталатын қозғалысты сипаттаңыз. Кескін мысалы референске еру үшін adaptive арақатынасын пайдаланады.

Профильге арналған ұзақтық нұсқаулығы төрттен он екіге дейінгі бүтін секундтарды немесе сол диапазонда ұзақтықты модель таңдауы үшін -1 мәнін көрсетеді. Әдепкі ұзақтық — бес секунд. Seedance 1.5 Pro әдепкісі — 720p; сақталған профиль кестесі 480p және 720p-ді құжаттайды, ал арнайы жұмыс нұсқаулығы 1.5 Pro үшін 1080p ұсынбайды. Тұрақты арақатынастар: 16:9, 4:3, 1:1, 3:4, 9:16 және 21:9; құжатталған 1.5 әдепкісі — adaptive. Сұралған мәндерді дайын қайтарылған материал деп қабылдамай, нақты клиптің ұзақтығы мен пропорцияларын тексеріңіз.

Сұрау екі өңдеу деңгейін ұсынады. service_tier=default online өңдеуін, ал flex көбірек кідіріске шыдайтын жұмыс үшін offline өңдеуін таңдайды. Тапсырма жіберілген соң бұл деңгейді өзгертуге болмайды. Оны жұмыс барысының уақыт талаптарына сай таңдап, сұрау жазбасында сақтаңыз. Дыбыс режимі мен өңдеу деңгейі — бөлек таңдаулар: дыбыссыз клип автоматты түрде offline тапсырмаға айналмайды, ал дыбысты қосу өңдеу деңгейін таңдамайды.

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

Пайдалану көлемі бейнетокендермен өлшенеді: шығыс ені × шығыс биіктігі × кадр жиілігі × шығыс ұзақтығы / 1024. Аяқталған тапсырма бұл мөлшерді usage.completion_tokens арқылы хабарлайды. Хабарланған пайдалану мөлшерін дайын клиппен және оның сұралған баптауларымен бірге сақтаңыз. Дыбыстың қосылуы не өшірілуі және online не flex өңдеуі пайдалануға негізделген төлемде бөлек санаттар болып қалады.

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

Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-1-5-pro-251215

doubao-seedance-1-5-pro-251215

ByteDance /doubao-seedance-1-5-pro-251215

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер doubao-seedance-1-5-pro-251215	Әдепкі—
Өріс`content`	Түрі`array`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Төл пішімдегі мәтін немесе медиа объектілері; сыртқы массив бос болмауы керек. Бұл әмбебап Ailoot құрастырушысы ішкі түйіндердің түрлерін тексермейді.	Әдепкі—
Өріс`duration`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Бастапқы 1.x схемасында 2–12 көрсетілген; кейінгі ортақ сипаттама 1.5 үшін 4–12 немесе -1 деп береді. Мысалда екі деректе де құжатталған 5 қолданылады.	Әдепкі5
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 480p, 720p Шарттар: Seedance 1.5 Pro 480p және 720p қолдайды; 1080p қолданылмайды. Құжатталған әдепкі ажыратымдылық — 720p.	Әдепкі720p
Өріс`ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Шарттар: Seedance 1.5 Pro үшін құжатталған әдепкі жақтар арақатынасы — adaptive. Тұрақты арақатынас нұсқалары өзгермейді.	Әдепкіadaptive
Өріс`service_tier`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер default, flex Шарттар: default=online, flex=offline; жасау алдында таңдаңыз.	Әдепкіdefault
Өріс`seed`	Түрі`integer`	ТалапМіндетті	Мәндер мен шектеулер Ең азы: -1 Ең көбі: 4 294 967 295	Әдепкі-1
Өріс`camerafixed`	Түрі`boolean`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Ailoot талап етеді; құжаттамада үлгі суреті қолданылғанда камераны басқаруға қолдау көрсетілмейтіні жазылған және оның әсеріне кепілдік берілмейді.	Әдепкіfalse
Өріс`watermark`	Түрі`boolean`	ТалапМіндетті	Мәндер мен шектеулер	Әдепкіfalse
Өріс`execution_expires_after`	Түрі`integer`	ТалапМіндетті	Мәндер мен шектеулер Ең азы: 3 600 Ең көбі: 259 200 Бірлік: секунд	Әдепкі172 800
Өріс`generate_audio`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Тек 1.5 үшін: жасалған бейнеге кірістірілген синхрондалған дыбыс.	Әдепкіtrue

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

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

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыcamerafixed, content, execution_expires_after, model, seed, watermark
Параметр`optional`	Параметр талаптарыduration, resolution, ratio, service_tier, generate_audio
Параметр`material_types`	Параметр талаптарыtext, image
Параметр`additional_properties`	Параметр талаптарыtrue
Параметр`validation_scope`	Параметр талаптарыAiloot міндетті өрістердің түрлерін және model/content массивінің бос еместігін тексереді. Сұраудың басқа өрістері таңдалған модель үшін сақталады.
Параметр`image_constraints`	Параметр талаптары{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":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 токен
БаптауӨңдеу деңгейі: офлайн (flex). Синхрондалған дыбысы бар нәтиже.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Аудио жасауАудиомен	Қызмет деңгейіflex	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.0024 1K бейне токені үшін
БаптауӨңдеу деңгейі: офлайн (flex). Синхрондалған дыбыссыз нәтиже.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Аудио жасауАудиосыз	Қызмет деңгейіflex	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.0012 1K бейне токені үшін
БаптауӨңдеу деңгейі: онлайн (default). Синхрондалған дыбысы бар нәтиже.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Аудио жасауАудиомен	Қызмет деңгейіdefault	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.0048 1K бейне токені үшін
БаптауӨңдеу деңгейі: онлайн (default). Синхрондалған дыбыссыз нәтиже.	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Аудио жасауАудиосыз	Қызмет деңгейіdefault	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.0024 1K бейне токені үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Аудио жасау—	Қызмет деңгейі—	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.1152 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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

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

Ailoot Ultra · Бейне

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

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}
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-1-5-pro-251215

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

/v1/videos/generations

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

doubao-seedance-1-5-pro-251215

FAQ · ByteDance: Seedance 1.5 Pro

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

ByteDance: Seedance 1.5 Pro