Accéder 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 pilote, ou l'insère dans la scène d'origine

Open model · Vidéo

Votre premier résultat apparaîtra ici

Construisez 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 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 lorsque vous les modifiez.

•obligatoire

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

•obligatoire image_url
Déposez un fichier ou

URL de l’image de référence du personnage fournissant le personnage à animer ou à remplacer, la vidéo de conduite déterminant l’animation ou le remplacement.

•obligatoire video_url
Déposez un fichier ou

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

resolution par défaut 512p

Résolution de sortie, avec orientation déterminée automatiquement par le ratio d’aspect de l’image de référence. En paysage, 512p correspond à 896x512 et 704p à 1280x704 ; en portrait, les valeurs correspondantes sont 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 d’origine, mais remplace le personnage par le sujet de la vidéo de conduite ; `animation` applique le mouvement de conduite au personnage.

driving_type par défaut end_to_end

Le mouvement d’animation provient directement d’une vidéo de conduite 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 un meilleur contrôle avec les entrées complexes.

subject_type par défaut human

Sélection du sujet de la vidéo de conduite, 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 rallonge le 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, avec un réglage recommandé de 3.0 lors de l’utilisation de 512p.

Graine de génération incluse dans la réponse, qu’elle ait été 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 à la 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` pilote montrant une personne, plusieurs personnes ou un animal. En mode `animation`, le personnage reproduit les mouvements de la vidéo pilote ; en mode `replacement`, il remplace le sujet tout en conservant la scène. La résolution est de 512p ou 704p, avec une orientation choisie à 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
promptobligatoire
Typestring
Invite spécifiant la vidéo de sortie souhaitée.
image_urlobligatoire image
Typeurl · image
URL de l’image de référence du personnage fournissant le personnage à animer ou à remplacer, la vidéo de conduite déterminant l’animation ou le remplacement.
video_urlobligatoire video
Typeurl · video
Fournissez une vidéo de conduite par URL, mettant en scène une personne, 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 d’origine, mais remplace le personnage par le sujet de la vidéo de conduite ; `animation` applique le mouvement de conduite au personnage.
driving_typefacultatif
Typeenum
Par défautend_to_end
end_to_endpose
Le mouvement d’animation provient directement d’une vidéo de conduite 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 un meilleur contrôle avec les entrées complexes.
subject_typefacultatif
Typeenum
Par défauthuman
humananimal
Sélection du sujet de la vidéo de conduite, 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, avec orientation déterminée automatiquement par le ratio d’aspect de l’image de référence. En paysage, 512p correspond à 896x512 et 704p à 1280x704 ; en portrait, les valeurs correspondantes sont 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 rallonge le 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, avec un réglage recommandé de 3.0 lors de l’utilisation de 512p.
seedfacultatif
Typeinteger | null
Graine de génération incluse dans la réponse, qu’elle ait été fournie explicitement ou sélectionnée aléatoirement parce que l’entrée était vide.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
obligatoire 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 sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'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 de conduite 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 de conduite Stage-A pour le débogage, disponible uniquement avec `output_preprocessing=true`.

Pour les agents IA : cette page au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/scail-2.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt