Seedance API zur Prompt-Optimierung

Eigenständiger Textdienst von APIMaster ohne Erstellung von Videoaufträgen. Er orientiert sich am öffentlichen Volcengine-Leitfaden, ist keine offizielle Seedance-API und verteilt den offiziellen Skill nicht.

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

Mit einem APIMaster API Key authentifizieren. model wählt das abgerechnete Textmodell mit verfügbarer Route und Key-Berechtigung. target_model ist das Videomodell; derzeit nur seedance-2.5. Bei Bedarf das Textmodell im Beispiel ersetzen.

Schnellstart

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": "de",
  "task": "generate",
  "duration": 5
}'

Parameter

JSON
model	Erforderlich: kostenpflichtiges Textmodell für die Optimierung.
prompt	Erforderlich: 1–12000 Zeichen. Referenzbezeichnungen und Dialoge beibehalten.
target_model	Optional: Standard und einziger erlaubter Wert ist seedance-2.5.
language	Optional: Ausgabesprache wie de oder en; sonst Eingabesprache. Höchstens 64 Bytes.
task	Optional: generate (Standard), edit oder extend.
duration	Optional: Ganzzahl 4–30 oder -1. Bei Bearbeitung weglassen oder -1. Nur Planungskontext, keine Einstellung der Videoparameter.
references	Optional: bis zu 50 Beschreibungen mit eindeutigem label (1–64 Zeichen) und description (1–2000 Zeichen). Medien werden weder abgerufen noch analysiert.

Antwort

Standard-JSON für Chat Completions: Ergebnis in choices[0].message.content, Tokenverbrauch in usage. Keine Videoauftrags-ID. Bei finish_reason ungleich stop, besonders length, Vollständigkeit prüfen.

{
  "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
  }
}

Referenzbeschreibungen

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

Fehler und Abrechnung

400 ungültiges JSON, Typen, Felder oder Werte; 401 ungültiger Key; 403 keine Berechtigung; 413 mehr als 64 KiB; 415 kein JSON; 429 Ratenlimit. Anbieterfehler behalten Format und Status des Text-Relays.

Token- und Gruppenpreise, Guthabenprüfung, Protokolle und Fehlerabrechnung des Textmodells gelten. Systemanweisungen und Beschreibungen zählen als Eingabetokens. Keine Videogebühr; spätere Videogenerierung wird separat berechnet.

Nach Prüfung ein Video erzeugen

Das vollständige Ergebnis als prompt an die Videogenerierung übergeben. Medien, Dauer und Seitenverhältnis separat senden. Labels müssen Reihenfolge und Rolle der Medien entsprechen. Ohne Medienprüfung keine Garantie für Identität, exakte Untertitel oder bildgenaues Timing.

Seedance 2.5

Grenzen

Nur Text ohne Streaming. Unbekannte Hauptfelder, einschließlich stream, messages, webhook und Medien-URLs, werden abgelehnt. Keine geheimen Schlüssel eingeben.