ByteDance: Seedance 1.0 Lite Text-to-Video
Seedance 1.0 Lite Text-to-Video жазбаша көрініс сипаттамасын дыбыссыз бейнеге айналдырады. Осы нақты Lite селекторы референс кескіннің орнына мәтінді пайдаланады; ұзақтығы 2–12 секунд, кадр жиілігі секундына 24 кадр, ал кадр пішімі көлденең, тік, шаршы немесе кинематографиялық болуы мүмкін.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Seedance 1.0 Lite Text-to-Video жазбаша сипатталған көріністен бейне жасайды. Нақты doubao-seedance-1-0-lite-t2v-250428 селекторы — Lite нұсқасындағы мәтіннен бейне жасауға арналған профиль. Нысанды, ортаны және қозғалысты тікелей сипаттауға болатын кезде пайдаланыңыз: үстелдегі тауар, орынның жалпы көрінісі немесе кейіпкердің қысқа әрекеті. Нәтиже — бейнеклип; 1.0 профилі синхрондалған дыбыс жасамайды.
Көріністі көрермен көруге тиіс ретпен жазыңыз. Нысанды және оның сыртқы түрін, орынды, әрекетті, план ірілігін және камера қозғалысын көрсетіп, соңғы композицияны сипаттаңыз. Тауарға арналған пайдалы тапсырмада ашық түсті тас тұғырдағы бөтелке, заттаңбаның үстімен жылжыған күн сәулесі және қақпаққа қарай баяу жақындаған камера болуы мүмкін. Бұлар — жаңа көрініске берілген нұсқаулар; модель ұсынылған тауар фотосын дәл қайталайды деген мәлімдеме емес. Көрінетін әрекетті таңдалған клип ұзақтығына сәйкестендіріңіз.
Бұл мәтіннен бейне жасау селекторы бөлек аталған Lite кескіннен бейне жасау селекторынан өзгеше. Мазмұны content массивінде мәтіндік элемент ретінде беріледі. Сөйлем адамды, затты немесе стильді сипаттай алады, бірақ референс кескінді тіркемейді және модель көрмеген файл бойынша нақты визуалды сәйкестікті белгілемейді. Көріністің бастапқы композициясы қолда бар кескіннен алынуы қажет болса, медиа өрісін қосқанда Lite t2v селекторы режимін өзгертеді деп ойламай, кескіндерді қолдайтын профильді таңдаңыз.
Құжатталған 1.0 ұзақтығы екіден он екі секундқа дейін, әдепкісі — бес секунд, кадр жиілігі тұрақты: секундына 24 кадр. Lite 480p, 720p және 1080p ажыратымдылықтарын ұсынады, құжатталған әдепкісі — 720p. Тұрақты арақатынастар: 16:9, 4:3, 1:1, 3:4, 9:16 және 21:9. Генерациядан бұрын кадрды қолданылатын орнына сай таңдаңыз: тік көрсетілімге — тік, шағын тауар панеліне — шаршы, кең көрініске — көлденең пішім. Ажыратымдылықтар мен арақатынастар сұралған нәтижені сипаттайды; жүктеп алынған клиптің нақты пиксель өлшемдерін және кадрлауын тексеріңіз.
Сұрауда seed бастапқы мәні, сутаңба және камераны басқару параметрлері бар. seed — -1 мен 2^32-1 аралығындағы бүтін сан; -1 кездейсоқ мәнді таңдайды. Камераны бекіту сұрауы бекітілген камера туралы нұсқауды қосады, ал құжаттама әсерге кепілдік берілмейтінін нақты айтады. Жазбаша көріністегі камера бағытын бөлек басқару параметрімен сәйкестендіріңіз. Мәтінге енгізілген параметр нұсқаулары бөлек қосымша параметрлерден басым, сондықтан екі жерде ұзақтық, ажыратымдылық немесе кадрлау жөнінде қайшы нұсқаулар бермеңіз.
Пайдалану көлемі бейнетокендермен өлшенеді: шығыс ені × шығыс биіктігі × кадр жиілігі × шығыс ұзақтығы / 1024. Аяқталған тапсырма бұл мөлшерді usage.completion_tokens арқылы хабарлайды. Хабарланған пайдалану мөлшерін дайын клиппен және оның сұралған баптауларымен бірге сақтаңыз.
Генерация асинхронды жүреді. Жіберу тапсырма идентификаторын қайтарады, ал тапсырманы сұрату оның өңделу күйін және сәтті аяқталғаннан кейін content.video_url ішіндегі бейне URL мекенжайын береді. Тапсырма кезекте немесе орындалу үстінде болғанда идентификаторды сақтап, келесі түзету үшін дайын клипті сақтаңыз. Жасалған файлдың құжатталған сақтау мерзімі — жеті күн. Сұрауда тапсырма жасалған сәттен есептелетін жарамдылық аралығы да бар; ол өткенде аяқталмаған тапсырма expired күйіне ауысады. Құжатталған әдепкі мән — 172800 секунд, рұқсат етілетін мәндер 3600 мен 259200 секунд аралығында.
Толық клипті тапсырмамен салыстырып тексеріңіз: көзделген нысан көріне ме, әрекет дұрыс ретпен орындала ма, камера сұралған бағытта қозғала ма және соңғы кадр пайдалануға жарамды ма. Келесі нұсқа үшін сәтті көрініс құрылымын сақтап, нақты бір нұсқауды өзгертіңіз. Бірнеше планнан тұратын тізбек үшін әр мәтіндік сұрауды, баптауларды және дайын бейнені сақтаңыз, сонда келесі көріністі нақты нәтижеге сүйеніп жоспарлауға болады.
Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-1-0-lite-t2v-250428
doubao-seedance-1-0-lite-t2v-250428
doubao-seedance-1-0-lite-t2v-250428Бастау
Seedance 1.0 Lite Text-to-Video жазбаша көрініс сипаттамасын дыбыссыз бейнеге айналдырады. Осы нақты Lite селекторы референс кескіннің орнына мәтінді пайдаланады; ұзақтығы 2–12 секунд, кадр жиілігі секундына 24 кадр, ал кадр пішімі көлденең, тік, шаршы немесе кинематографиялық болуы мүмкін.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер doubao-seedance-1-0-lite-t2v-250428 | Әдепкі— |
Өрісcontent | Түріarray | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Төл пішімдегі мәтін немесе медиа объектілері; сыртқы массив бос болмауы керек. Бұл әмбебап Ailoot құрастырушысы ішкі түйіндердің түрлерін тексермейді. | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 2 Ең көбі: 12 Шарттар: Бастапқы 1.x схемасында 2–12 көрсетілген; кейінгі ортақ сипаттама 1.5 үшін 4–12 немесе -1 деп береді. Мысалда екі деректе де құжатталған 5 қолданылады. | Әдепкі5 |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 480p, 720p, 1080p Шарттар: Ортақ санамаланған мәндер; үлгі суреттермен және 1.5 үшін 1080p қолданылмайды. Ішкі pro сипаттамасында 480p/1080p тізілген, ал жоғарғы деңгейдегі мәндерде 720p бар; pro үшін 720p қолдауы жөніндегі қайшылық шешілмеген және кепілдік берілмейді. | Әдепкі720p |
Өріс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 |
Параметрadditional_properties | Параметр талаптарыtrue |
Параметрvalidation_scope | Параметр талаптарыAiloot міндетті өрістердің түрлерін және model/content массивінің бос еместігін тексереді. Сұраудың басқа өрістері таңдалған модель үшін сақталады. |
Әдістің балама атаулары: /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.003 1K бейне токені үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептеу бірлігі— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.144 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-lite-t2v-250428","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}/contentGET /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-lite-t2v-250428
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · ByteDance: Seedance 1.0 Lite Text-to-Video
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:text→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Қандай шектеулер қолданылады?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200