API оптимизации промптов Seedance

Независимый текстовый сервис APIMaster, не создающий видеозадачи. Реализован по публичному руководству Volcengine; это не официальный API Seedance, официальный Skill не распространяется.

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

Используйте API Key APIMaster. model — оплачиваемая текстовая модель с доступным маршрутом и разрешением ключа. target_model — видеомодель; поддерживается только seedance-2.5. При необходимости замените текстовую модель из примера.

Быстрый старт

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

Параметры

JSON
model	Обязательный: ID платной текстовой модели для оптимизации.
prompt	Обязательный: 1–12000 символов. Сохраняйте метки материалов и реплики.
target_model	Необязательный: по умолчанию и единственное значение — seedance-2.5.
language	Необязательный: язык ответа, например ru или en; иначе язык ввода. До 64 байт.
task	Необязательный: generate (по умолчанию), edit или extend.
duration	Необязательный: целое 4–30 или -1. Для редактирования пропустите или задайте -1. Только контекст планирования, без настройки генерации.
references	Необязательный: до 50 описаний с уникальным label (1–64 символа) и description (1–2000). Медиа не загружаются и не анализируются.

Ответ

Стандартный JSON Chat Completions: результат в choices[0].message.content, расход в usage. ID видеозадачи нет. Если finish_reason отличается от stop, особенно length, проверьте полноту результата.

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

Описания материалов

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

Ошибки и оплата

400 неверный JSON, типы, поля или значения; 401 неверный ключ; 403 нет доступа; 413 более 64 KiB; 415 не JSON; 429 лимит запросов. Ошибки поставщика сохраняют формат и статус текстового шлюза.

Действуют тарифы текстовой модели и группы, проверка баланса, журналы и расчёт при ошибках. Системные инструкции и описания входят во входные токены. Плата за видео здесь не взимается; последующая генерация оплачивается отдельно.

Создание видео после проверки

Передайте полный результат как prompt видеогенерации. Медиа, длительность и пропорции задаются отдельно. Метки должны соответствовать порядку и роли материалов. Без просмотра медиа нельзя гарантировать идентичность персонажей, точные субтитры или покадровое время.

Seedance 2.5

Ограничения

Только текст без потоковой передачи. Неизвестные поля верхнего уровня, включая stream, messages, webhook и URL медиа, отклоняются. Не передавайте секретные ключи.