Passer au contenu

PixVerse C1 Reference To Video

Intégrer

Identifiant du modèle pixverse/c1/reference-to-video
# 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/pixverse/c1/reference-to-video?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_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  }'

# 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"

Cette requête: 0,25 $ 250 crédits API L’exécuter sur cette page

Obtenir une clé API
PixVerse Référence vers vidéo Audio natifEntrées de référence1–15 sjusqu’à 1080p #video-generation#reference-to-video#pixverse#character-consistency

Vidéo C1 qui conserve la cohérence des personnages et des arrière-plans à partir de 7 images de référence maximum

PixVerse · 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.

•requis

Prompt de référence vers vidéo, dans lequel les références importées sont désignées par @ref_name. Même un texte visuellement court peut dépasser la limite maximale de 2048 octets en UTF-8 : les emoji, les lettres accentuées et les caractères non latins occupent plusieurs octets chacun ; la limite s’applique donc à la taille encodée, et non au nombre de caractères.

aspect_ratio par défaut 16:9

Rapport d’aspect de la vidéo de sortie.

resolution par défaut 720p

Résolution de la vidéo de sortie.

par défaut 5

Durée de la vidéo générée, de 1 à 15 secondes.

•requis

Images de référence fournies avec un type et un ref_name pour chaque entrée, afin que chaque image puisse être désignée dans le prompt par @ref_name.

Avancé seed · enable_safety_checker

Graine pour une génération vidéo reproductible. Une reproduction exacte à chaque exécution nécessite une version du modèle, un prompt et une graine inchangés.

POST /run/pixverse/c1/reference-to-video?wait=20 devis → 0,25 $
# 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/pixverse/c1/reference-to-video?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_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  }'

# 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 PixVerse C1 Reference To Video

Génère une vidéo à partir de 1 à 7 entrées dans `image_references`, chacune avec un type et un nom. Utilisez `@ref_name` dans le `prompt` pour désigner une référence. Le modèle prend en charge huit rapports hauteur/largeur, dont 21:9 et 2:3, des résolutions jusqu’à 1080p, des durées de 1 à 15 secondes et un audio généré facultatif.

Paramètres

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

NomType Par défautAutorisé Description
promptrequis
Typestring
Prompt de référence vers vidéo, dans lequel les références importées sont désignées par @ref_name. Même un texte visuellement court peut dépasser la limite maximale de 2048 octets en UTF-8 : les emoji, les lettres accentuées et les caractères non latins occupent plusieurs octets chacun ; la limite s’applique donc à la taille encodée, et non au nombre de caractères.
aspect_ratiofacultatif
Typeenum
Par défaut16:9
16:94:31:13:49:162:33:221:9
Rapport d’aspect de la vidéo de sortie.
resolutionfacultatif
Typeenum
Par défaut720p
360p540p720p1080p
Résolution de la vidéo de sortie.
durationfacultatif
Typeinteger
Par défaut5
1 – 15
Durée de la vidéo générée, de 1 à 15 secondes.
seedfacultatif
Typeinteger | null
Graine pour une génération vidéo reproductible. Une reproduction exacte à chaque exécution nécessite une version du modèle, un prompt et une graine inchangés.
generate_audio_switchfacultatif generate_audio
Typeboolean
Par défautfalse
Activation de la génération audio pour la musique de fond, les effets sonores et les dialogues.
image_referencesrequis
Typeobject[]
≤ 7 éléments
Images de référence fournies avec un type et un ref_name pour chaque entrée, afin que chaque image puisse être désignée dans le prompt par @ref_name.
image_references[].image_urlrequis
Typeurl · image
URL pointant vers l’image de référence.
image_references[].typefacultatif
Typeenum
Par défautsubject
subjectbackground
Catégorie de référence : 'subject' identifie un personnage ou un objet, tandis que 'background' identifie une scène ou un environnement.
image_references[].ref_namerequis
Typestring
Identifiant de référence (ref_name) : choisissez un nom court permettant au prompt de désigner cette image par @ref_name.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
requis Nom canonique, également accepté

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixverse/c1/reference-to-video",
  "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": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_references": [
      {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "ref_name": "character"
      }
    ]
  },
  "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
    }
  },
  "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 au Go-mois) ou 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, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Fichier vidéo produit par la génération.

Plus de modèles : Référence vers vidéo

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/pixverse/c1/reference-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt