Мазмұнға өту

Scail 2

Интеграциялау

Модель идентификаторы scail-2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/scail-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Мысалдағыдай файлдар: 2,00 $ 2 000 API кредиті файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
Open model Бейнеден бейнеге 704p дейін #stylized#transform

Басқарушы бейнедегі қозғалыс арқылы эталон кейіпкерінің кескінін жандандырады немесе оны бастапқы көрініске ауыстырады

Open model · Бейне

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті

Қажетті шығыс бейнесін сипаттайтын нұсқау.

•міндетті image_url
Файлды тастаңыз немесе

Анимацияланатын немесе алмастырылатын кейіпкерді беретін анықтамалық кейіпкер кескінінің URL мекенжайы; жетекші бейне анимацияны немесе алмастыруды анықтайды.

•міндетті video_url
Файлды тастаңыз немесе

Бір адам, бірнеше адам немесе жануар бейнеленген қозғалысты басқаратын бейнені URL арқылы беріңіз.

resolution әдепкі 512p

Бағдар бағыты анықтамалық кескіннің aspect ratio мәні бойынша автоматты анықталатын шығыс ажыратымдылығы. Альбомдық бағытта 512p 896x512, ал 704p 1280x704 мәніне сәйкес келеді; портреттік бағытта тиісінше 512x896 және 704x1280 қолданылады.

Қосымша mode · driving_type · subject_type · num_inference_steps · guidance_scale · shift · seed · enable_safety_checker
mode әдепкі animation

Анықтамалық кейіпкерді пайдалану тәсілін таңдаңыз: `replacement` бастапқы көріністі сақтап, кейіпкерді жетекші нысанмен алмастырады; `animation` жетекші қозғалысты кейіпкерге қолданады.

driving_type әдепкі end_to_end

Анимация қозғалысы SAM3 арқылы `end_to_end` көмегімен маскаланған жетекші бейнеден тікелей алынады; бұл әдепкі әрі барынша тұрақты ұсынылатын таңдау. Балама ретінде `pose` NLF/DWPose арқылы сол бейнеден нақты қаңқа жасап, көбірек басқару мүмкіндігін береді.

subject_type әдепкі human

Жетекші бейнедегі нысанды таңдау; `animal` мәні `human` емес нысандар үшін SAM3 анықтау нұсқауын баптайды.

әдепкі 40

Diffusion sampling қадамдарының саны. Оны арттыру сапаны жақсартады, бірақ ұзағырақ уақыт алады.

әдепкі 5

Нұсқауға сәйкестік пен шығармашылық арасындағы тепе-теңдікті реттейтін classifier-free guidance күші.

әдепкі 3

Flow matching үшін noise-schedule жылжуы; 512p қолданғанда ұсынылатын мәні 3.0.

Нақты берілсе де, кіріс бос қалғандықтан кездейсоқ таңдалса да, жауапқа қосылатын генерация seed мәні.

POST /run/scail-2?wait=20 бағасы → 2,00 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/scail-2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Scail 2 туралы

Адамды, бірнеше адамды немесе жануарды көрсететін сілтемелік кейіпкер `image_url` және жетекші `video_url` қабылдайды. `animation` режимінде кейіпкер жетекші қозғалысты орындайды; `replacement` режимінде көріністі сақтай отырып нысанды алмастырады. Ажыратымдылық 512p немесе 704p, бағдар кескіннен алынады. `driving_type` тікелей end-to-end басқаруды немесе нақты поза қаңқасын қолдана алады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
promptміндетті
Түріstring
Қажетті шығыс бейнесін сипаттайтын нұсқау.
image_urlміндетті image
Түріurl · image
Анимацияланатын немесе алмастырылатын кейіпкерді беретін анықтамалық кейіпкер кескінінің URL мекенжайы; жетекші бейне анимацияны немесе алмастыруды анықтайды.
video_urlміндетті video
Түріurl · video
Бір адам, бірнеше адам немесе жануар бейнеленген қозғалысты басқаратын бейнені URL арқылы беріңіз.
modeміндетті емес
Түріenum
Әдепкіanimation
animationreplacement
Анықтамалық кейіпкерді пайдалану тәсілін таңдаңыз: `replacement` бастапқы көріністі сақтап, кейіпкерді жетекші нысанмен алмастырады; `animation` жетекші қозғалысты кейіпкерге қолданады.
driving_typeміндетті емес
Түріenum
Әдепкіend_to_end
end_to_endpose
Анимация қозғалысы SAM3 арқылы `end_to_end` көмегімен маскаланған жетекші бейнеден тікелей алынады; бұл әдепкі әрі барынша тұрақты ұсынылатын таңдау. Балама ретінде `pose` NLF/DWPose арқылы сол бейнеден нақты қаңқа жасап, көбірек басқару мүмкіндігін береді.
subject_typeміндетті емес
Түріenum
Әдепкіhuman
humananimal
Жетекші бейнедегі нысанды таңдау; `animal` мәні `human` емес нысандар үшін SAM3 анықтау нұсқауын баптайды.
resolutionміндетті емес
Түріenum
Әдепкі512p
512p704p
Бағдар бағыты анықтамалық кескіннің aspect ratio мәні бойынша автоматты анықталатын шығыс ажыратымдылығы. Альбомдық бағытта 512p 896x512, ал 704p 1280x704 мәніне сәйкес келеді; портреттік бағытта тиісінше 512x896 және 704x1280 қолданылады.
num_inference_stepsміндетті емес
Түріinteger
Әдепкі40
2 – 50
Diffusion sampling қадамдарының саны. Оны арттыру сапаны жақсартады, бірақ ұзағырақ уақыт алады.
guidance_scaleміндетті емес
Түріnumber
Әдепкі5
1 – 10
Нұсқауға сәйкестік пен шығармашылық арасындағы тепе-теңдікті реттейтін classifier-free guidance күші.
shiftміндетті емес
Түріnumber
Әдепкі3
1 – 10
Flow matching үшін noise-schedule жылжуы; 512p қолданғанда ұсынылатын мәні 3.0.
seedміндетті емес
Түріinteger | null
Нақты берілсе де, кіріс бос қалғандықтан кездейсоқ таңдалса да, жауапқа қосылатын генерация seed мәні.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Шақырушы авторизацияланған болса, false мәнін орнату арқылы тексеруді жеңілдетуге болады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "scail-2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 2000,
    "usd": "2.00",
    "charged": 2000,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "preprocessing_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "preprocessing_mask_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
video
object {url, content_type, file_name, file_size}Генерация нәтижесінде алынған бейне файлы.
seed
integerБейне генерациясына қолданылатын seed.
preprocessing_video
object {url, content_type, file_name, file_size} | nullDiffusion моделіне берілген Stage-A pose-conditioning кірісін қамтитын жөндеу бейнесі; тек `output_preprocessing=true` болғанда қолжетімді. Мазмұны `driving_type` мәніне тәуелді: `end_to_end` SAM3 арқылы маскаланған жетекші кадрларды, ал `driving_type=pose` NLF/DWPose жасаған қаңқаны пайдаланады.
preprocessing_mask_video
object {url, content_type, file_name, file_size} | nullЖөндеуге арналған Stage-A жетекші маска бейнесі; тек `output_preprocessing=true` болғанда қолжетімді.

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/scail-2.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt