Passer au contenu

Scail 2

Intégrer

Identifiant du modèle 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"

Fichiers comme dans l’exemple: 2,00 $ 2 000 crédits API vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Open model Vidéo vers vidéo jusqu’à 704p #stylized#transform

Anime l'image d'un personnage de référence avec les mouvements d'une vidéo de pilotage, ou l'insère dans la scène d'origine

Open model · Vidéo

Votre premier résultat apparaîtra ici

Créez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou pendant 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour au fur et à mesure de vos modifications.

•requis

Invite spécifiant la vidéo de sortie souhaitée.

•requis image_url
Déposez un fichier ou

URL de l’image de référence du personnage fournissant le personnage à animer ou à remplacer par un sujet; la vidéo source détermine l’animation ou le remplacement.

•requis video_url
Déposez un fichier ou

Fournissez par URL une vidéo source de mouvement mettant en scène une personne seule, plusieurs personnes ou un animal.

resolution par défaut 512p

Résolution de sortie dont l’orientation est déterminée automatiquement par le rapport hauteur/largeur de l’image de référence. En paysage, 512p correspond à 896x512 et 704p à 1280x704; en portrait, les valeurs sont respectivement 512x896 et 704x1280.

Avancé mode · driving_type · subject_type · num_inference_steps · guidance_scale · shift · seed · enable_safety_checker
mode par défaut animation

Choisissez comment utiliser le personnage de référence : `replacement` conserve la scène originale, mais remplace le personnage par le sujet source; `animation` applique le mouvement source au personnage.

driving_type par défaut end_to_end

Le mouvement d’animation provient directement d’une vidéo source masquée par SAM3 avec `end_to_end`, le choix par défaut recommandé pour une robustesse maximale. Sinon, `pose` utilise NLF/DWPose pour générer un squelette explicite à partir de cette vidéo, offrant davantage de contrôle avec les entrées difficiles.

subject_type par défaut human

Sélection du sujet de la vidéo source, avec `animal` configurant l’invite de détection de SAM3 pour les sujets autres que `human`.

par défaut 40

Nombre d’étapes d’échantillonnage de diffusion. L’augmenter améliore la qualité, mais accroît la durée du traitement.

par défaut 5

Intensité du guidage sans classifieur, équilibrant l'adhésion à l'invite et la créativité.

par défaut 3

Décalage du calendrier de bruit pour le flow matching; une valeur de 3.0 est recommandée avec 512p.

Graine de génération incluse dans la réponse, qu’elle soit fournie explicitement ou sélectionnée aléatoirement parce que l’entrée était vide.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement au Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Scail 2

Prend une `image_url` de personnage de référence et une `video_url` de pilotage montrant une personne, plusieurs personnes ou un animal. En mode `animation`, le personnage reproduit les mouvements de pilotage; en mode `replacement`, il remplace le sujet tout en conservant la scène. La résolution est de 512p ou 704p, avec une orientation déterminée à partir de l'image. `driving_type` peut utiliser un pilotage direct de bout en bout ou un squelette de pose explicite.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
promptrequis
Typestring
Invite spécifiant la vidéo de sortie souhaitée.
image_urlrequis image
Typeurl · image
URL de l’image de référence du personnage fournissant le personnage à animer ou à remplacer par un sujet; la vidéo source détermine l’animation ou le remplacement.
video_urlrequis video
Typeurl · video
Fournissez par URL une vidéo source de mouvement mettant en scène une personne seule, plusieurs personnes ou un animal.
modefacultatif
Typeenum
Par défautanimation
animationreplacement
Choisissez comment utiliser le personnage de référence : `replacement` conserve la scène originale, mais remplace le personnage par le sujet source; `animation` applique le mouvement source au personnage.
driving_typefacultatif
Typeenum
Par défautend_to_end
end_to_endpose
Le mouvement d’animation provient directement d’une vidéo source masquée par SAM3 avec `end_to_end`, le choix par défaut recommandé pour une robustesse maximale. Sinon, `pose` utilise NLF/DWPose pour générer un squelette explicite à partir de cette vidéo, offrant davantage de contrôle avec les entrées difficiles.
subject_typefacultatif
Typeenum
Par défauthuman
humananimal
Sélection du sujet de la vidéo source, avec `animal` configurant l’invite de détection de SAM3 pour les sujets autres que `human`.
resolutionfacultatif
Typeenum
Par défaut512p
512p704p
Résolution de sortie dont l’orientation est déterminée automatiquement par le rapport hauteur/largeur de l’image de référence. En paysage, 512p correspond à 896x512 et 704p à 1280x704; en portrait, les valeurs sont respectivement 512x896 et 704x1280.
num_inference_stepsfacultatif
Typeinteger
Par défaut40
2 – 50
Nombre d’étapes d’échantillonnage de diffusion. L’augmenter améliore la qualité, mais accroît la durée du traitement.
guidance_scalefacultatif
Typenumber
Par défaut5
1 – 10
Intensité du guidage sans classifieur, équilibrant l'adhésion à l'invite et la créativité.
shiftfacultatif
Typenumber
Par défaut3
1 – 10
Décalage du calendrier de bruit pour le flow matching; une valeur de 3.0 est recommandée avec 512p.
seedfacultatif
Typeinteger | null
Graine de génération incluse dans la réponse, qu’elle soit fournie explicitement ou sélectionnée aléatoirement parce que l’entrée était vide.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
La vérification peut être assouplie en définissant false, si l’appelant est autorisé.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Fichier vidéo produit par la génération.
seed
integerGraine utilisée pour la génération vidéo.
preprocessing_video
object {url, content_type, file_name, file_size} | nullVidéo de débogage contenant l’entrée de conditionnement de pose Stage-A fournie au modèle de diffusion, disponible uniquement avec `output_preprocessing=true`. Son contenu dépend de `driving_type` : `end_to_end` utilise des séquences source masquées par SAM3, tandis que `driving_type=pose` utilise un squelette généré par NLF/DWPose.
preprocessing_mask_video
object {url, content_type, file_name, file_size} | nullVidéo du masque source Stage-A pour le débogage, disponible uniquement avec `output_preprocessing=true`.

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/scail-2.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt