Ugrás a tartalomhoz

Scail 2

Integráció

Modellazonosító 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"

A példához hasonló fájlok: 2,00 $ 2000 API-jóváírás a fájljaidat a futtatás előtt megmérjük Futtatás ezen az oldalon

API-kulcs beszerzése
Open model Videóból videó legfeljebb 704p #stylized#transform

Referencia-karakterképet animál egy vezérlővideó mozgásával, vagy az eredeti jelenetbe helyettesíti

Open model · Videó

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező

A kívánt kimeneti videót megadó prompt.

•kötelező image_url
Húzz egy fájlt ide, vagy

A karakter animálásához vagy alanyhelyettesítéshez használt karakterreferencia-kép URL-je; a vezérlővideó határozza meg az animációt vagy a cserét.

•kötelező video_url
Húzz egy fájlt ide, vagy

URL-címen megadott mozgásvezérlő videó, amely egyetlen embert, több embert vagy egy állatot ábrázol.

resolution alapértelmezett: 512p

Kimeneti felbontás, amelynek tájolását automatikusan a referencia képének képaránya határozza meg. Fekvő tájolásnál az 512p érték 896x512, a 704p pedig 1280x704; álló tájolásnál rendre 512x896 és 704x1280.

Speciális mode · driving_type · subject_type · num_inference_steps · guidance_scale · shift · seed · enable_safety_checker
mode alapértelmezett: animation

A referencia-karakter felhasználásának módja: a `replacement` megőrzi az eredeti jelenetet, de a karaktert a vezérlővideó alanyára cseréli; az `animation` a vezérlőmozgást alkalmazza a karakteren.

driving_type alapértelmezett: end_to_end

Az animáció mozgása közvetlenül a SAM3 által maszkolt vezérlővideóból származik `end_to_end` esetén, amely az alapértelmezett és a maximális robusztussághoz ajánlott beállítás. Alternatívaként a `pose` NLF/DWPose használatával explicit csontvázat renderel a videóból, ami nagyobb vezérlést biztosít nehéz bemeneteknél.

subject_type alapértelmezett: human

A vezérlővideó alanyának kiválasztása; az `animal` úgy konfigurálja a SAM3 detektálási promptját, hogy a `human` értéktől eltérő alanyokat keressen.

alapértelmezett: 40

Diffúziós mintavételezési lépések száma. Növelése javítja a minőséget, de hosszabb ideig tart.

alapértelmezett: 5

A classifier-free guidance erőssége, amely egyensúlyt teremt a prompt követése és a kreativitás között.

alapértelmezett: 3

Zajütemezési eltolás flow matching esetén; 512p használatakor az ajánlott beállítás 3.0.

A válaszban szereplő generálási seed, akár explicit módon lett megadva, akár véletlenszerűen lett kiválasztva, mert a bemenet üres maradt.

POST /run/scail-2?wait=20 ár → 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"

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) Scail 2 bemutatása

Egy emberi, több emberes vagy állatos vezérlővideót és referencia-karaktert tartalmazó `image_url` értéket, valamint `video_url` értéket fogad. `animation` módban a karakter a vezérlő mozgását végzi, `replacement` módban pedig lecseréli az alanyt, miközben megtartja a jelenetet. A felbontás 512p vagy 704p lehet, a tájolást pedig a kép határozza meg. A `driving_type` közvetlen végpontok közötti vezérlést vagy explicit pózcsontvázat használhat.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
promptkötelező
Típusstring
A kívánt kimeneti videót megadó prompt.
image_urlkötelező image
Típusurl · image
A karakter animálásához vagy alanyhelyettesítéshez használt karakterreferencia-kép URL-je; a vezérlővideó határozza meg az animációt vagy a cserét.
video_urlkötelező video
Típusurl · video
URL-címen megadott mozgásvezérlő videó, amely egyetlen embert, több embert vagy egy állatot ábrázol.
modenem kötelező
Típusenum
Alapértelmezettanimation
animationreplacement
A referencia-karakter felhasználásának módja: a `replacement` megőrzi az eredeti jelenetet, de a karaktert a vezérlővideó alanyára cseréli; az `animation` a vezérlőmozgást alkalmazza a karakteren.
driving_typenem kötelező
Típusenum
Alapértelmezettend_to_end
end_to_endpose
Az animáció mozgása közvetlenül a SAM3 által maszkolt vezérlővideóból származik `end_to_end` esetén, amely az alapértelmezett és a maximális robusztussághoz ajánlott beállítás. Alternatívaként a `pose` NLF/DWPose használatával explicit csontvázat renderel a videóból, ami nagyobb vezérlést biztosít nehéz bemeneteknél.
subject_typenem kötelező
Típusenum
Alapértelmezetthuman
humananimal
A vezérlővideó alanyának kiválasztása; az `animal` úgy konfigurálja a SAM3 detektálási promptját, hogy a `human` értéktől eltérő alanyokat keressen.
resolutionnem kötelező
Típusenum
Alapértelmezett512p
512p704p
Kimeneti felbontás, amelynek tájolását automatikusan a referencia képének képaránya határozza meg. Fekvő tájolásnál az 512p érték 896x512, a 704p pedig 1280x704; álló tájolásnál rendre 512x896 és 704x1280.
num_inference_stepsnem kötelező
Típusinteger
Alapértelmezett40
2 – 50
Diffúziós mintavételezési lépések száma. Növelése javítja a minőséget, de hosszabb ideig tart.
guidance_scalenem kötelező
Típusnumber
Alapértelmezett5
1 – 10
A classifier-free guidance erőssége, amely egyensúlyt teremt a prompt követése és a kreativitás között.
shiftnem kötelező
Típusnumber
Alapértelmezett3
1 – 10
Zajütemezési eltolás flow matching esetén; 512p használatakor az ajánlott beállítás 3.0.
seednem kötelező
Típusinteger | null
A válaszban szereplő generálási seed, akár explicit módon lett megadva, akár véletlenszerűen lett kiválasztva, mert a bemenet üres maradt.
enable_safety_checkernem kötelező
Típusboolean
Alapértelmezetttrue
A szűrés a false érték beállításával enyhíthető, ha a hívó jogosult erre.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
video
object {url, content_type, file_name, file_size}A generálással létrehozott videófájl.
seed
integerVideógeneráláshoz használt seed.
preprocessing_video
object {url, content_type, file_name, file_size} | nullA diffúziós modellnek átadott Stage-A pózkondicionáló bemenetet tartalmazó hibakeresési videó, csak `output_preprocessing=true` esetén érhető el. Tartalma a `driving_type` értékétől függ: `end_to_end` esetén SAM3 által maszkolt vezérlőfelvételt, `driving_type=pose` esetén NLF/DWPose által renderelt csontvázat használ.
preprocessing_mask_video
object {url, content_type, file_name, file_size} | nullHibakereséshez használt Stage-A vezérlőmaszk-videó, csak `output_preprocessing=true` esetén érhető el.

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/scail-2.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt