API optymalizacji promptów Seedance

Niezależna usługa tekstowa APIMaster, bez tworzenia zadań wideo. Oparta na publicznym przewodniku Volcengine; nie jest oficjalnym API Seedance i nie rozpowszechnia oficjalnego Skill.

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

Użyj API Key APIMaster. model wybiera płatny model tekstowy z dostępną trasą i uprawnieniami klucza. target_model oznacza model wideo; obsługiwany jest tylko seedance-2.5. W razie potrzeby zmień model tekstowy z przykładu.

Szybki start

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

Parametry

JSON
model	Wymagany: ID płatnego modelu tekstowego do optymalizacji.
prompt	Wymagany: 1–12000 znaków. Zachowaj etykiety i dialogi.
target_model	Opcjonalny: domyślnie i jedyna wartość to seedance-2.5.
language	Opcjonalny: język wyniku, np. pl lub en; inaczej język wejściowy. Maksymalnie 64 bajty.
task	Opcjonalny: generate (domyślnie), edit lub extend.
duration	Opcjonalny: liczba całkowita 4–30 lub -1. Przy edycji pomiń lub użyj -1. Tylko kontekst planowania, bez ustawiania parametrów wideo.
references	Opcjonalny: do 50 opisów z unikalnym label (1–64 znaki) i description (1–2000 znaków). Media nie są pobierane ani analizowane.

Odpowiedź

Standardowy JSON Chat Completions: wynik w choices[0].message.content, zużycie w usage. Bez ID zadania wideo. Gdy finish_reason nie jest stop, szczególnie length, sprawdź kompletność.

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

Opisy materiałów

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

Błędy i rozliczenia

400 nieprawidłowy JSON, typ, pole lub wartość; 401 błędny klucz; 403 brak uprawnień; 413 ponad 64 KiB; 415 nie JSON; 429 limit żądań. Błędy dostawcy zachowują format i status usługi tekstowej.

Obowiązują ceny tokenów i grup modelu tekstowego, kontrola salda, dzienniki i rozliczenia błędów. Instrukcje systemowe i opisy wliczają się do tokenów wejściowych. Bez opłaty za wideo; późniejsze generowanie jest płatne osobno.

Generowanie po sprawdzeniu

Przekaż pełny wynik jako prompt do generowania wideo. Media, czas i proporcje wyślij osobno. Etykiety muszą odpowiadać kolejności i roli materiałów. Bez analizy mediów brak gwarancji tożsamości postaci, dokładnych napisów lub czasu co do klatki.

Seedance 2.5

Ograniczenia

Tylko tekst bez streamingu. Nieznane pola główne, w tym stream, messages, webhook i URL mediów, są odrzucane. Nie podawaj tajnych kluczy.