API de optimización de prompts Seedance

Servicio de texto independiente de APIMaster. No crea tareas de vídeo. Sigue la guía pública de Volcengine; no es una API oficial de Seedance ni redistribuye el Skill oficial.

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

Autentícate con una API Key de APIMaster. model es el modelo de texto facturado y requiere una ruta disponible y permisos de la Key. target_model es el modelo de vídeo; solo admite seedance-2.5. Sustituye el modelo de texto del ejemplo si no está disponible.

Inicio rápido

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

Parámetros

JSON
model	Obligatorio: ID de modelo de texto de pago para optimizar.
prompt	Obligatorio: 1–12000 caracteres. Conserva las etiquetas y el diálogo.
target_model	Opcional: seedance-2.5 por defecto y único valor permitido.
language	Opcional: idioma de salida, como es o en; si se omite, sigue la entrada. Máximo 64 bytes.
task	Opcional: generate (predeterminado), edit o extend.
duration	Opcional: entero 4–30 o -1. En edición, omitir o usar -1. Solo orienta la planificación, no configura la generación.
references	Opcional: hasta 50 descripciones con label único (1–64 caracteres) y description (1–2000). No descarga ni analiza medios.

Respuesta

JSON estándar de Chat Completions: resultado en choices[0].message.content, consumo en usage. No devuelve ID de tarea de vídeo. Si finish_reason no es stop, especialmente length, comprueba que el resultado esté completo.

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

Descripciones de referencias

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

Errores y facturación

400 JSON, tipos, campos o valores inválidos; 401 Key inválida; 403 sin permiso; 413 más de 64 KiB; 415 contenido no JSON; 429 límite de solicitudes. Los errores del proveedor conservan el formato y estado del servicio de texto.

Se aplican los precios por tokens y grupo del modelo de texto, comprobaciones de saldo, registros y liquidación de fallos. Las instrucciones del sistema y descripciones cuentan como entrada. No hay cargo de vídeo; la generación posterior se factura aparte.

Generar vídeo tras revisar

Envía el resultado completo como prompt de generación. Adjunta medios, duración y proporción por separado. Las etiquetas deben coincidir con el orden y función de los medios. Sin inspección de medios no se garantiza identidad, subtítulos exactos ni tiempos por fotograma.

Seedance 2.5

Límites

Solo texto sin streaming. Se rechazan campos raíz desconocidos, incluidos stream, messages, webhook y URL de medios. No incluyas claves secretas.