Accéder 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

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

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 restylée souhaitée.

•obligatoire video_url
Déposez un fichier ou

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

•obligatoire image_url
Déposez un fichier ou

Référence d'identité et de style pour la régénération vidéo, fournie sous forme d'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 applicables.

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, identifiant 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 : un plus grand nombre 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 à la 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 restylée (`image_url`), guidée par un `prompt`. Jusqu’à 5 `keyframes` peuvent préserver l’identité dans les clips longs. La sortie est en 480p ou 720p avec `num_frames` de 17 à 241 ; `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
promptobligatoire
Typestring
Invite spécifiant la vidéo restylée souhaitée.
video_urlobligatoire video
Typeurl · video
Référence de mouvement et de cadrage pour la génération, fournie sous forme d'URL de la vidéo source.
image_urlobligatoire image
Typeurl · image
Référence d'identité et de style pour la régénération vidéo, fournie sous forme d'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_urlobligatoire
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 plus de 0.1 de celui de la sortie. L'image apparaît sans modification à `frame_index`.
keyframes[].frame_indexobligatoire
Typeinteger
≥ 1
Placez l'image clé à une position de sortie supérieure ou égale à 1 et inférieure au nombre total d'images de sortie, avec un indexage commençant à 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 applicables.
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, identifiant 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 : un plus grand nombre 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.
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": "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 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
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 au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/id-v2v.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt