API d’optimisation de prompts Seedance

Service texte indépendant d’APIMaster, sans création de tâche vidéo. Il suit le guide public Volcengine ; ce n’est pas une API officielle Seedance et le Skill officiel n’est pas redistribué.

POST https://apimaster.ai/v1/video/prompt-optimize

Utilisez une clé APIMaster. model désigne le modèle texte facturé, avec une route disponible et les permissions nécessaires. target_model désigne le modèle vidéo : seul seedance-2.5 est accepté. Remplacez le modèle texte de l’exemple si nécessaire.

Démarrage rapide

curl --fail-with-body -sS "https://apimaster.ai/v1/video/prompt-optimize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-3.1-flash-lite",
  "target_model": "seedance-2.5",
  "prompt": "A cat watches raindrops on a window, then turns toward the camera.",
  "language": "fr",
  "task": "generate",
  "duration": 5
}'

Paramètres

JSON
model	Obligatoire : modèle texte payant pour l’optimisation.
prompt	Obligatoire : 1–12000 caractères. Conservez les références et les dialogues.
target_model	Facultatif : seedance-2.5 par défaut, seule valeur acceptée.
language	Facultatif : langue de sortie, par exemple fr ou en. Sinon, langue d’entrée. Maximum 64 octets.
task	Facultatif : generate (défaut), edit ou extend.
duration	Facultatif : entier 4–30 ou -1. En édition, omettre ou utiliser -1. Contexte de planification uniquement, sans réglage des paramètres de génération.
references	Facultatif : jusqu’à 50 descriptions avec label unique (1–64 caractères) et description (1–2000 caractères). Aucun média téléchargé ou analysé.

Réponse

JSON Chat Completions standard : résultat dans choices[0].message.content, consommation dans usage. Aucun ID de tâche vidéo. Si finish_reason diffère de stop, notamment length, vérifiez que le résultat est complet.

{
  "object": "chat.completion",
  "model": "gemini-3.1-flash-lite",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A cat sits beside a rain-covered window, watching the drops slide down the glass. It slowly turns its head toward the camera."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 600,
    "completion_tokens": 50,
    "total_tokens": 650
  }
}

Descriptions des références

{
  "model": "gemini-3.1-flash-lite",
  "prompt": "Use @Image1 for the person and @Video1 for the camera movement.",
  "language": "fr",
  "references": [
    {
      "label": "@Image1",
      "description": "Person appearance only; ignore the background."
    },
    {
      "label": "@Video1",
      "description": "Slow camera push-in only; ignore the people."
    }
  ]
}

Erreurs et facturation

400 JSON, types, champs ou valeurs invalides ; 401 clé invalide ; 403 accès refusé ; 413 corps supérieur à 64 KiB ; 415 contenu non JSON ; 429 limitation. Les erreurs amont conservent le format et le statut du relais texte.

Tarification par tokens et groupe du modèle texte, contrôles de solde, journaux et traitement des échecs habituels. Les instructions système et les descriptions comptent en entrée. Aucuns frais vidéo ici ; la génération ultérieure est facturée séparément.

Générer après vérification

Passez le résultat complet comme prompt à la génération vidéo. Envoyez séparément médias, durée et ratio. Les labels doivent correspondre à l’ordre et au rôle des médias. Sans inspection des médias, aucune garantie sur l’identité, les sous-titres exacts ou la synchronisation à l’image près.

Seedance 2.5

Limites

Texte sans streaming uniquement. Les champs racine inconnus, dont stream, messages, webhook et les URL de médias, sont refusés. Ne transmettez pas de secrets.