FR ▾
Obtenir une clé API

AccueilGuide

Mis à jour le

Comment demander à une IA d'écrire un script : structure du prompt

Si vous voulez savoir comment obtenir une IA pour écrire un script que vous pouvez réellement filmer ou doubler, la réponse réside dans la structure : indiquez au modèle à qui s'adresse le script, sa durée et la forme que doit prendre la sortie.

Tuiles de notes liées menant à une pile de pages de script et à un clap, illustrant l'écriture de script basée sur un plan
Récipient en verre se remplissant de blocs lumineux pendant qu'une flèche tourne en boucle, illustrant la fenêtre de contexte d'un agent

Points clés

  1. Donnez au modèle un rôle, une longueur en mots, un ton et un format de sortie. Chaque élément manquant devient une supposition.
  2. Les courts scripts tiennent en un seul appel. Les longs nécessitent un plan d'abord, puis des appels acte par acte.
  3. Utilisez une température autour de 0,8 pour les ébauches et plus basse pour les révisions ; définissez des séquences d'arrêt si vous avez besoin d'une fin stricte.
  4. La fenêtre de 100 000 tokens contient un plan complet ainsi que tous les actes précédents, vous n'avez donc que rarement besoin d'astuces.

Aucune carte nécessaire. Après l'inscription, réclamez 0,50 $ de crédit d'essai gratuit en un clic (une fois par personne).

Obtenir une clé API

La réponse courte : cinq parties dans le prompt

La plupart des scripts faibles proviennent de prompts faibles. Une requête comme « écris un script sur le café » laisse le modèle choisir la longueur, la voix, le format et le point de vue. Donnez-lui plutôt ces cinq parties :

  1. Objectif : ce que le spectateur doit ressentir ou faire à la fin.
  2. Audience et ton : « nouveaux parents, chaleureux et un peu fatigués » fonctionne mieux que « amical ».
  3. Longueur : en mots, car les modèles comptent mieux les mots que les secondes. Environ 150 mots correspondent à une minute de parole.
  4. Format : scénario, voix off et visuels en deux colonnes, ou narration simple.
  5. Contraintes : éléments à éviter, noms à conserver, une dernière ligne obligatoire.

Voici la différence en pratique. Un prompt faible : « Écrire un script sur le sommeil. » Un plus fort : « Écrire une narration de 120 mots pour une vidéo de 50 secondes qui persuade les travailleurs de bureau de cesser de vérifier les emails au lit. Ton : doux, légèrement drôle. Ouvrez avec une question. Terminez par une action concrète qu'ils peuvent faire ce soir. Ne mentionnez pas les médicaments. » Le second prompt coûte environ quarante tokens de plus et supprime la plupart des tours de réécriture. Traitez les mots supplémentaires comme la révision la moins chère que vous ferez jamais.

C'est toute la méthode. Le reste de cette page montre comment transformer cela en appels API, et comment le mettre à l'échelle lorsque le script est long. Si vous avez juste besoin d'un test rapide, la page clé API donne aux nouveaux comptes un petit crédit d'essai.

Choisissez un format et indiquez-le

Les modèles copient le format que vous leur montrez. Si vous voulez un script en deux colonnes, montrez une ligne. Un petit exemple dans le prompt vaut mieux qu'un paragraphe de description.

curl https://api.aivideogenapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "temperature": 0.8,
    "messages": [
      {"role": "system", "content": "You are a scriptwriter. Output a two-column script. Format each row as: VISUAL | NARRATION. About 150 words of narration in total. No headings."},
      {"role": "user", "content": "Topic: why airports smell the way they do. Tone: wry. Audience: adults who travel for work."}
    ]
  }'

La même requête fonctionne avec n'importe quel client OpenAI une fois que l'URL de base est https://api.aivideogenapi.com/v1. Les détails sur l'authentification et les champs se trouvent dans la documentation.

Pour les scripts de dialogue, nommez les interlocuteurs dans le prompt et donnez à chacun une note vocale d'une ligne (« Mara : franc-parler, phrases courtes. Ilya : sur-explique »). Sans cela, les personnages ont tendance à se ressembler dès la deuxième page.

Paramètres qui influencent le résultat

Quelques paramètres sont plus importants que les autres.

ParamètreUtilisez-le pourValeur typique
temperatureVariété de formulations0,7 à 0,9 pour les ébauches, 0,3 à 0,5 pour les modifications
top_pSupprime les mots improbables0,9 à 0,95 ; modifiez ceci ou la température, pas les deux
max_tokensLimite maximale sur la longueur de la réponseOptionnel ; définissez-le lorsque vous voulez une protection contre une sortie qui dérape
stopFin sur un marqueurPar exemple « FIN SCÈNE »
frequency_penaltyRéduit les phrases répétées0,2 à 0,5 pour les longs scripts
seedBrouillons reproductiblesUn entier

Ces paramètres sont transmis au modèle. Ne vous attendez pas à une sortie identique à partir de la même graine après avoir modifié le prompt d'un seul mot.

Scripts courts : un appel suffit

Un script de 30 à 90 secondes représente quelques centaines de mots. Envoyez une requête unique avec les cinq parties et demandez une seule ébauche. Utilisez ensuite un deuxième message pour les modifications, car modifier une ébauche fonctionne mieux que régénérer depuis zéro.

from openai import OpenAI

client = OpenAI(base_url="https://api.aivideogenapi.com/v1", api_key="YOUR_KEY")

messages = [
    {"role": "system", "content": "You write tight scripts for short videos. Plain narration, no stage directions."},
    {"role": "user", "content": "Purpose: make viewers check their router settings. Tone: calm, a little amused. Length: 140 words."},
]
draft = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.8)
text = draft.choices[0].message.content

messages += [
    {"role": "assistant", "content": text},
    {"role": "user", "content": "Keep the structure. Replace the opening line with a question, and cut the last sentence."},
]
final = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.4)
print(final.choices[0].message.content)

Remarquez la baisse de température dans le second appel. Les révisions doivent suivre les instructions, pas explorer. Si vous voulez voir le script apparaître, ajoutez stream: true et imprimez chaque bloc à son arrivée ; les totaux d'utilisation arrivent à la fin du streaming. Une requête streaming occupe un de vos slots de concurrence jusqu'à sa fin, ce qui compte lorsque vous lancez plusieurs ébauches en parallèle. Une clé complète permet 8 appels simultanés.

Scripts longs : plan d'abord, puis actes

Demandez 4 000 mots d'un coup et le milieu s'affaisse : le modèle précipite la fin, répète des idées et oublie des faits mineurs. Un meilleur schéma comporte trois étapes.

Étape 1 : le plan

Demandez un plan numéroté avec une phrase par scène, le but de chaque scène et une liste continue de faits qui doivent rester cohérents (noms, lieux, ce que chaque personnage sait). Modifiez-le à la main. C'est l'endroit le moins cher pour corriger une histoire.

Étape 2 : acte par acte

Pour chaque acte, envoyez le plan, les règles de style, un court résumé des actes précédents et le texte complet du dernier acte. Demandez uniquement le prochain acte.

acts = []
summary = "None yet."
for n, goal in enumerate(outline_acts, start=1):
    prompt = (
        f"Outline:\n{outline_text}\n\nStory so far (summary): {summary}\n"
        f"Previous act, full text:\n{acts[-1] if acts else '(none)'}\n\n"
        f"Write act {n}: {goal}. About 600 words. Match the voice of the previous act."
    )
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "system", "content": STYLE_RULES}, {"role": "user", "content": prompt}],
        temperature=0.8,
    )
    acts.append(r.choices[0].message.content)
    summary = summarize(acts)  # one more short call

Étape 3 : la relecture

Renvoyez le script complet et demandez une liste de contradictions et de lignes répétées, pas une réécriture. Corrigez-les avec des modifications ciblées.

Utilisation de la fenêtre de 100 000 tokens

Le prompt plus la réponse peut atteindre 100 000 tokens, soit environ 70 000 mots. Un plan complet, un guide de style et chaque acte terminé d'un script de long métrage tiennent confortablement. Cela signifie que vous pouvez souvent sauter les résumés et envoyer simplement toute l'histoire jusqu'à présent, ce qui préserve les petits détails.

Deux mises en garde. Premièrement, le coût augmente car chaque appel renvoie l'historique. Deuxièmement, les prompts très longs fonctionnent encore mieux lorsque les instructions les plus importantes sont à la fin, près de la requête. Mettez la tâche actuelle en dernier, après le matériel de référence. La page sur la fenêtre de contexte approfondit la façon d'organiser les longues entrées.

Vérification des prix pour un script de 10 minutes construit en actes : supposons que les appels totalisent 6 000 tokens d'entrée et 4 000 tokens de sortie. Cela fait 6 000 / 1 000 000 x $0,15 = $0,0009 pour l'entrée et 4 000 / 1 000 000 x $0,50 = $0,002 pour la sortie, soit $0,0029 au total. Les prix sont listés sur la page tarifs.

Problèmes courants et solutions

  • Le script est trop long ou trop court. Indiquez une plage de mots et ajoutez un point d'arrêt. Vérifiez le nombre de mots dans le code et demandez une réduction avec le nombre exact.
  • Chaque scène s'ouvre de la même manière. Ajoutez une pénalité de fréquence et une ligne telle que « Variez comment les scènes commencent ; n'ouvrez jamais deux scènes avec un son ou un détail météo. »
  • Le ton dérive. Collez deux lignes exemples de la voix cible dans le message système et indiquez au modèle qu'il s'agit d'une référence de style, pas de texte à réutiliser.
  • Les didascalies s'infiltrent dans la narration. Demandez des champs séparés (mode JSON avec response_format défini sur json_object) pour que narration et visuels ne partagent jamais une même chaîne.
  • HTTP 429. Vous avez touché une limite. Le code rate_limited signifie trop de requêtes par minute, concurrency signifie trop en même temps. Attendez et réessayez.

Questions et réponses

Combien de mots dois-je demander par minute de vidéo ?

Prévoyez environ 150 mots parlés par minute à un rythme calme. Les clips sociaux rapides peuvent atteindre 170 ou plus, donc testez avec une vraie voix off.

Dois-je générer tout le script en une seule requête ?

Pour moins d'environ 800 mots, oui. Pour les scripts plus longs, écrivez un plan d'abord et générez acte par acte, en passant le plan et le dernier acte à chaque fois.

Le modèle garde-t-il une mémoire entre les requêtes ?

Non. Chaque requête est indépendante, vous devez donc envoyer l'historique que vous souhaitez qu'il voie dans la liste des messages.

Peut-il écrire des scripts de fiction sombre ou mature ?

Le modèle est ajusté pour répondre sans refus de contenu pour une utilisation adulte licite. Le contenu sexuel impliquant des mineurs n'est jamais autorisé.

Votre clé n'est qu'à un formulaire

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API