API di ottimizzazione dei prompt Seedance

Servizio testuale indipendente di APIMaster, senza creare attività video. Segue la guida pubblica Volcengine; non è un’API ufficiale Seedance e non ridistribuisce lo Skill ufficiale.

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

Usa una API Key APIMaster. model sceglie il modello di testo fatturato, con un percorso disponibile e i permessi della Key. target_model indica il modello video; è supportato solo seedance-2.5. Sostituisci il modello di testo dell’esempio se necessario.

Avvio rapido

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

Parametri

JSON
model	Obbligatorio: ID del modello di testo a pagamento per l’ottimizzazione.
prompt	Obbligatorio: 1–12000 caratteri. Conserva etichette e dialoghi.
target_model	Facoltativo: predefinito e unico valore accettato è seedance-2.5.
language	Facoltativo: lingua di uscita, ad esempio it o en; altrimenti segue l’ingresso. Massimo 64 byte.
task	Facoltativo: generate (predefinito), edit o extend.
duration	Facoltativo: intero 4–30 o -1. Per modifiche, ometti o usa -1. Solo contesto di pianificazione, senza impostare parametri video.
references	Facoltativo: fino a 50 descrizioni con label univoco (1–64 caratteri) e description (1–2000). Nessun download o analisi dei media.

Risposta

JSON Chat Completions standard: risultato in choices[0].message.content, consumo in usage. Nessun ID di attività video. Se finish_reason non è stop, soprattutto length, verifica la completezza.

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

Descrizioni dei riferimenti

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

Errori e fatturazione

400 JSON, tipi, campi o valori non validi; 401 Key non valida; 403 accesso negato; 413 oltre 64 KiB; 415 non JSON; 429 limite richieste. Gli errori del fornitore mantengono formato e stato del servizio testuale.

Si applicano prezzi per token e gruppo, controlli saldo, registri e gestione degli errori del modello di testo. Istruzioni di sistema e descrizioni contano come input. Nessun costo video qui; la generazione successiva è fatturata separatamente.

Genera un video dopo la verifica

Invia il risultato completo come prompt alla generazione video. Media, durata e proporzioni si inviano separatamente. Le etichette devono corrispondere a ordine e ruolo dei media. Senza analisi dei media non si garantiscono identità, sottotitoli esatti o tempi al fotogramma.

Seedance 2.5

Limiti

Solo testo senza streaming. Campi radice sconosciuti, inclusi stream, messages, webhook e URL dei media, vengono rifiutati. Non inserire chiavi segrete.