ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro мәтіннен немесе бастапқы кескіннен дыбыссыз бейне жасайды. Әрекет пен камераны сипаттаңыз немесе қолда бар композицияны жандандырыңыз: ұзақтығы 2–12 секунд, кадр жиілігі секундына 24 кадр; шығыс кадрлауы мен ажыратымдылығы бөлек басқарылады.

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

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

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

Seedance 1.0 Pro мәтіннен немесе кескін бағыттайтын көріністен бейне жасайды. doubao-seedance-1-0-pro-250528 селекторы екі кіріс режимін де қолдайды, сондықтан бастапқы негіз жазбаша тұжырым немесе қолда бар визуалды композиция болуы мүмкін. Жаңа көрініс жасау үшін мәтіндік тапсырманы, ал нысанды, орналасуды және бастапқы көріністі визуалды түрде белгілеу керек болса, кескінді беріңіз. Бұл 1.0 профилі дыбыссыз бейне шығарады; синхрондалған дыбыс бөлек сипатталған 1.5 Pro профиліне жатады.

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

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

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

Құжатталған 1.0 ұзақтығы екіден он екі секундқа дейін, кадр жиілігі секундына 24 кадр. Шығыс баптауларында 480p, 720p және 1080p бар, Pro әдепкісі — 1080p; нұсқаулық бойынша референс кескін қолданылғанда 1080p қолжетімсіз. Тұрақты кадр пішімдері: 16:9, 4:3, 1:1, 3:4, 9:16 және 21:9. Кескінге негізделген план үшін барлық мәтіннен бейне жасау баптауларын өзгеріссіз көшірмей, кескінге сай параметрлер үйлесімін таңдаңыз. Клипті макетке орналастырмас бұрын нақты қайтарылған кадрлауды тексеріңіз.

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

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

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

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

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер doubao-seedance-1-0-pro-250528	Әдепкі—
Өріс`content`	Түрі`array`	ТалапМіндетті	Мәндер мен шектеулер Шарттар: Төл пішімдегі мәтін немесе медиа объектілері; сыртқы массив бос болмауы керек. Бұл әмбебап Ailoot құрастырушысы ішкі түйіндердің түрлерін тексермейді.	Әдепкі—
Өріс`duration`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 2 Ең көбі: 12 Шарттар: Бастапқы 1.x схемасында 2–12 көрсетілген; кейінгі ортақ сипаттама 1.5 үшін 4–12 немесе -1 деп береді. Мысалда екі деректе де құжатталған 5 қолданылады.	Әдепкі5
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: Мәтіннен бейне жасау үшін расталған мәндер — 480p және 1080p. Үлгі суреті бар кіріс 1080p мәніне жол бермейді. Ортақ 720p санамаланған мәні модельге арналған сипаттамаға қайшы келеді, сондықтан екі режимде де 720p қолдауы анықталмаған күйде қалады.	Әдепкі1080p
Өріс`ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 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

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

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

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыcamerafixed, content, execution_expires_after, model, seed, watermark
Параметр`optional`	Параметр талаптарыduration, resolution, ratio, service_tier
Параметр`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 токен
БаптауUltra	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі1K бейне токені үшін	Төлем Шығыс · Тек салыстыруға арналған бағалау $0.0044 1K бейне токені үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.2112 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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-0-pro-250528","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
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-0-pro-250528

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

/v1/videos/generations

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

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

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

ByteDance: Seedance 1.0 Pro