Tareas asíncronas y webhooks
Cada generación devuelve un 202 y un id de tarea de inmediato. Consulta la tarea o recibe webhooks firmados con cada cambio de estado.
API de Seedance 2.0con precio por segundo
Una sola clave para Seedance 2.0 Mini y Fast. Primero cotiza, envía con una clave de idempotencia y recibe un webhook cuando la tarea termine.
Las generaciones reales aún no están habilitadas
Deja tu correo y te escribiremos una sola vez, cuando se habiliten.
El acceso a la API para desarrolladores requiere aprobación previa.
curl https://api.pershot.app/v1/videos/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-fast",
"prompt": "Perfume mist in hard side light. Slow push-in, black background, grain.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"max_credits": 34
}'{
"id": "job_01J9ZK4T8W",
"object": "job",
"kind": "video",
"status": "queued",
"money_status": "reserved",
"queue_position": 2,
"requested_model": "seedance-2.0-fast",
"credits_quoted": 34,
"credits_charged": null
}Precio por segundosegún la resolución
Se factura por segundo de video. Una tarea que lee un video también factura sus segundos de entrada, con una tarifa más baja.
| Modelo | 480p | 720p |
|---|---|---|
| Seedance 2.0 MiniEntrada de texto o imagen | 0,020 US$/s≈ 500 s por 10 US$ | 0,042 US$/s≈ 238 s por 10 US$ |
| Seedance 2.0 MiniCon entrada de video | 0,012 US$/s≈ 833 s por 10 US$ | 0,025 US$/s≈ 400 s por 10 US$ |
| Seedance 2.0 FastEntrada de texto o imagen | 0,031 US$/s≈ 322 s por 10 US$ | 0,067 US$/s≈ 149 s por 10 US$ |
| Seedance 2.0 FastCon entrada de video | 0,019 US$/s≈ 526 s por 10 US$ | 0,040 US$/s≈ 250 s por 10 US$ |
Lo que traecada llamada
Un límite en cada llamada
Envía un quote_id o un límite max_credits. Nunca cobramos por encima de él, y una solicitud Auto sin límite se rechaza.
Reintentos que nunca cobran dos veces
El mismo Idempotency-Key dentro de 24 horas devuelve la misma tarea, así que un reintento después de un tiempo de espera agotado es seguro.
Uso que puedes conciliar
Uso por día, clave y modelo, en JSON o CSV. Los precios salen de la lista de precios de la API para desarrolladores, nunca de una clave.
¿Vienes defal o Replicate?
Los nombres de campo siguen las entradas habituales de Seedance cuando existen. El acceso es por solicitud, para automatizar tu propio trabajo. Lo que cambia:
- Endpoint
- POST https://api.pershot.app/v1/videos/generations y luego GET https://api.pershot.app/v1/jobs/job_… con el id devuelto para obtener el resultado.
- Autenticación
- Authorization: Bearer con una clave que empieza por sk_test_ o sk_live_.
- Idempotencia
- Un encabezado Idempotency-Key en cada solicitud de generación.
- Límite de precio
- Un límite max_credits o un quote_id de POST /v1/quotes.
- Audio
- generate_audio true o false; el precio es el mismo.
- ID de usuario
- Para cuentas de desarrollador aprobadas (por solicitud): etiqueta una solicitud con tu propio id de usuario en el end_user_id opcional, y el uso lo muestra.
También en Claude y Codex
Inicia sesión por MCP y gasta tu saldo creativo, como el estudio, con una verificación de precio antes de gastar nada. Ese saldo está separado del saldo de la API para desarrolladores.
Preguntassobre la API
¿Las claves de API cuestan algo?
No. Las claves son gratis, y el acceso requiere aprobación previa: pídelo en el estudio. Cada llamada se paga con el saldo de la API para desarrolladores, que está separado del saldo creativo.
¿Cómo se cotiza una llamada?
Por segundo facturado: 0,067 US$ en 720p con Fast, 0,020 US$ en 480p con Mini. Los segundos de video de entrada también cuentan, con una tarifa más baja.
¿Se me cobra por las tareas fallidas?
No. Los créditos retenidos se reembolsan cuando una tarea no produce video (falla o se rechaza el contenido) o un control de seguridad bloquea el resultado, y la tarea indica el motivo. Una tarea que entrega un video se cobra.
¿Cuáles son los límites?
60 solicitudes por minuto por clave. La cuenta de la API para desarrolladores ejecuta 3 tareas a la vez de forma predeterminada, más a pedido. Un plan de membresía sube el límite de la cuenta creativa, no el de esta, y las claves adicionales no agregan capacidad.
¿Cuándo puedo usarla?
Las generaciones reales de Seedance aún no están habilitadas. Deja tu correo en la página de un modelo y te escribiremos una sola vez, cuando se habiliten.