ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast — мәтіннен және кескіннен дыбыссыз бейне жасауға арналған бөлек аталған Fast профилі. Ол көрініс тапсырмасын немесе кескінге негізделген композицияны қабылдайды; нәтиже ұзақтығы 2–12 секунд, кадр жиілігі секундына 24 кадр және кадрлау бөлек басқарылады.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Seedance 1.0 Pro Fast — doubao-seedance-1-0-pro-fast-251015 арқылы анықталатын Fast профилі. Ол жазбаша көріністен немесе кескінге негізделген бастапқы композициядан дыбыссыз бейне жасайды. Нақты селектор бұл профильді Seedance 1.0 Pro-дан ажыратады; Fast сөзі жеке тапсырманың кепілді аяқталу уақытын білдірмейді. Көріністі не белгілеуге тиіс екеніне қарай кіріс режимін таңдап, қайтарылған клипті сол тапсырмамен салыстырыңыз.
Мәтінге негізделген план қысқа реттіліктен басталады: нысан мен орта, әрекет, камера траекториясы және соңғы көрініс. Тауарды ашып көрсету үшін тірек бетіндегі затты, оның материалына түскен жарықты және көрсетілетін ерекшелікпен аяқталатын қысқа қозғалысты сипаттаңыз. Орынның көрінісін жобалағанда кең жалпы планнан танылатын назар нүктесіне өтіңіз. Бір қысқа клиптен бірнеше байланыссыз көріністі орындауды сұрамаңыз: олардың нысандары мен орталарын әр жолы басынан таныстыру қажет болады.
Кескінге негізделген план content массивіндегі image_url элементінен және қозғалыс туралы мәтіндік нұсқаудан басталады. Кадрлауды, фонды және нысандардың орналасуын сол кескінде дайындап, қай элементтер қозғалатынын және камера қалай әрекет ететінін айтыңыз. Осылайша статикалық композиция қысқа анимациялық көрініске айналады. Бұл портретке, үстелдегі затқа немесе дайын визуалды тұжырымға ыңғайлы, бірақ нақты нәтижеде клип бойындағы сәйкестік, пішін және қозғалыс бәрібір тексерілуі керек.
Кіріс кескіндері қолжетімді URL немесе Base64 data URL арқылы беріле алады. Құжатталған пішімдер: JPEG, PNG, WEBP, BMP, TIFF және GIF; кескін көлемі 30 MB-тан аз, екі өлшемі де қатаң түрде 300 бен 6000 пиксель арасында, ал енінің биіктігіне қатынасы қатаң түрде 0.4 пен 2.5 арасында болуы керек. Нысан бөлшектері көрінетін таза бастапқы кескінді таңдаңыз. Кескін нұсқаулығы бейімделмелі кадрлауды ұсынады, сондықтан дайын бастапқы кескіннің пропорциялары жандандырғыңыз келетін композицияға сәйкес келуі керек.
1.0 профилінің құжаттамасында секундына 24 кадр жиілігінде екіден он екі секундқа дейінгі ұзақтық көрсетілген. Pro Fast әдепкі ажыратымдылығы — 1080p, ал сақталған шығыс кестесінде 480p, 720p және 1080p көрсетілген. Жұмыс нұсқаулығы референс кескін сценарийі үшін 1080p-ді алып тастайды. Тұрақты арақатынастар: 16:9, 4:3, 1:1, 3:4, 9:16 және 21:9. Барлық үйлесім өзара алмастырылады деп ойламай, таңдалған кіріс режиміне сай ажыратымдылық пен пішімді таңдаңыз.
Бастапқы мән және сутаңба баптаулары сұрау параметрлерін айқын сақтауға көмектеседі. Бүтін seed мәнінің диапазоны -1 мен 2^32-1 аралығында; -1 кездейсоқтықты сұрайды. Камераны бекіту нұсқауы шартты: нұсқаулық оны референс кескін сценарийінде алып тастайды және қолдау бар жерде визуалды әсерге кепілдік бермейді. Мәтінге енгізілген параметр нұсқаулары бөлек қосымша параметрлерден басым болады. Бұл нұсқауларды өзара сәйкестендіріңіз, әсіресе ескі ұзақтық немесе ажыратымдылық командасы көрініс сипаттамасында қалып қоюы мүмкін сұрауды түзеткенде.
Пайдалану көлемі бейнетокендермен өлшенеді: шығыс ені × шығыс биіктігі × кадр жиілігі × шығыс ұзақтығы / 1024. Аяқталған тапсырма бұл мөлшерді usage.completion_tokens арқылы хабарлайды. Хабарланған пайдалану мөлшерін дайын клиппен және оның сұралған баптауларымен бірге сақтаңыз.
Жіберу асинхронды тапсырма жасайды. Оның идентификаторын сақтап, күйін қадағалаңыз және сәтті аяқталғаннан кейін дайын бейнені content.video_url арқылы алыңыз. Құжаттама бойынша жасалған файлдар жеті күн сақталады, сондықтан дайын материалды мәтіндік сұраумен және бар болса, кіріс кескінімен бірге сақтаңыз. Толық әрекетті, камера қозғалысын және соңғы кадрлауды тексеріңіз; бір бөлшек тапсырмаға сәйкес келмесе, сәтті бөліктерді сақтап, сол нақты түзетуді сипаттаңыз.
Ailoot Ultra · Бейне POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Бастау
Seedance 1.0 Pro Fast — мәтіннен және кескіннен дыбыссыз бейне жасауға арналған бөлек аталған Fast профилі. Ол көрініс тапсырмасын немесе кескінге негізделген композицияны қабылдайды; нәтиже ұзақтығы 2–12 секунд, кадр жиілігі секундына 24 кадр және кадрлау бөлек басқарылады.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер doubao-seedance-1-0-pro-fast-251015 | Әдепкі— |
Өріс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.0012 1K бейне токені үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептеу бірлігі— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.0576 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","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-pro-fast-251015
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Қандай шектеулер қолданылады?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200