Passer au contenu

ID-V2V

Intégrer

Identifiant du modèle id-v2v
# 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/id-v2v?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",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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: 1,013 $ 1 013 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’à 720p #stylized#transform#editing

Restylise une vidéo à partir d’une première image restylisée en conservant l’identité et les mouvements du sujet

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 précisant la vidéo restylée souhaitée.

•requis video_url
Déposez un fichier ou

Référence de mouvement et de cadrage pour la génération, fournie par l'URL de la vidéo source.

•requis image_url
Déposez un fichier ou

Référence d'identité et de style pour la régénération vidéo, fournie par une URL pointant vers la première image restylée.

resolution par défaut 720p

Choisissez 720p pour une sortie 1280×720 ou 720×1280, ou 480p pour une sortie 832×480 ou 480×832. L'orientation de la vidéo source détermine les dimensions utilisées.

par défaut 81

Limite le nombre d'images à produire; si la source en contient moins, son nombre d'images devient la limite supérieure.

Avancé segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

Invite de sélection du sujet pour SAM-3, qui identifie la région dont les pixels guideront la génération. En dehors de ce sujet segmenté, la génération n'est pas contrainte.

par défaut 30

Contrôle de la qualité et de la vitesse du clip, exprimé sous forme de nombre d'étapes d'échantillonnage de diffusion pour chaque clip: davantage d'étapes améliore la qualité, mais augmente la durée.

par défaut 5

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

par défaut 1

Adhésion structurelle à la vidéo source, ajustée par l'échelle de conditionnement VACE.

Graine aléatoire partagée entre tous les clips lors de la génération de plusieurs clips, permettant une génération reproductible.

Points d'ancrage d'identité facultatifs pour les vidéos longues: fournissez des images clés restylées avec les indices d'image de sortie où elles doivent apparaître.

POST /run/id-v2v?wait=20 devis → 1,013 $
# 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/id-v2v?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",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 ID-V2V

Régénère une vidéo source (`video_url`) dans le style d’une première image restylisée (`image_url`), guidée par un `prompt`. Jusqu’à 5 `keyframes` peuvent ancrer l’identité dans les clips plus longs. La sortie est en 480p ou 720p avec `num_frames` de 17 à 241, et `segmentation_prompt` (person par défaut) sélectionne le sujet dont les pixels conditionnent le résultat.

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 précisant la vidéo restylée souhaitée.
video_urlrequis video
Typeurl · video
Référence de mouvement et de cadrage pour la génération, fournie par l'URL de la vidéo source.
image_urlrequis image
Typeurl · image
Référence d'identité et de style pour la régénération vidéo, fournie par une URL pointant vers la première image restylée.
keyframesfacultatif
Typeobject[]
≤ 5 éléments
Points d'ancrage d'identité facultatifs pour les vidéos longues: fournissez des images clés restylées avec les indices d'image de sortie où elles doivent apparaître.
keyframes[].image_urlrequis
Typeurl · image
URL de l'image restylée pour un point d'ancrage d'identité dans une vidéo longue; le format d'image ne doit pas différer de celui de la sortie de plus de 0.1. L'image apparaît sans modification à `frame_index`.
keyframes[].frame_indexrequis
Typeinteger
≥ 1
Placez l'image clé à une position de sortie d'au moins 1 et inférieure au nombre total d'images de sortie, avec un indexage à partir de 0. La position 0 est réservée à l'image de départ restylée provenant de `image_url`.
resolutionfacultatif
Typeenum
Par défaut720p
480p720p
Choisissez 720p pour une sortie 1280×720 ou 720×1280, ou 480p pour une sortie 832×480 ou 480×832. L'orientation de la vidéo source détermine les dimensions utilisées.
num_framesfacultatif
Typeinteger
Par défaut81
17 – 241
Limite le nombre d'images à produire; si la source en contient moins, son nombre d'images devient la limite supérieure.
segmentation_promptfacultatif
Typestring
Par défautperson
≤ 100 caractères
Invite de sélection du sujet pour SAM-3, qui identifie la région dont les pixels guideront la génération. En dehors de ce sujet segmenté, la génération n'est pas contrainte.
num_inference_stepsfacultatif
Typeinteger
Par défaut30
2 – 40
Contrôle de la qualité et de la vitesse du clip, exprimé sous forme de nombre d'étapes d'échantillonnage de diffusion pour chaque clip: davantage d'étapes améliore la qualité, mais augmente la durée.
guidance_scalefacultatif
Typenumber
Par défaut5
1 – 10
Intensité du guidage sans classifieur, équilibrant l'adhésion à l'invite et la créativité.
vace_scalefacultatif
Typenumber
Par défaut1
0 – 2
Adhésion structurelle à la vidéo source, ajustée par l'échelle de conditionnement VACE.
seedfacultatif
Typeinteger | null
Graine aléatoire partagée entre tous les clips lors de la génération de plusieurs clips, permettant une génération reproductible.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Active les contrôles de sécurité sur les entrées et les sorties.
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": "id-v2v",
  "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": 1013,
    "usd": "1.013",
    "charged": 1013,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
  },
  "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
integerValeur de graine appliquée pendant la génération.

Plus de modèles : Vidéo vers vidéo

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