Skip to main content
GET
Consultar Estado de Tarea

Autorizaciones

Authorization
string
header
requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Parámetros de ruta

task_id
string
requerido

ID de tarea, ignora {} al consultar, agrega el id del cuerpo de respuesta de la tarea asíncrona al final de la ruta

Respuesta

Detalles del estado de la tarea

created
integer

Marca de tiempo de creación de la tarea

Ejemplo:

1756817821

id
string

ID de tarea

Ejemplo:

"task-unified-1756817821-4x3rx6ny"

model
string

Modelo utilizado

Ejemplo:

"gemini-3-pro-image-preview"

object
enum<string>

Tipo de tarea

Opciones disponibles:
image.generation.task,
video.generation.task,
audio.generation.task
Ejemplo:

"image.generation.task"

progress
integer

Porcentaje de progreso de la tarea

Rango requerido: 0 <= x <= 100
Ejemplo:

100

status
enum<string>

Estado de la tarea. Nota: mientras la tarea sigue pendiente en el proveedor, la API de consulta ya devuelve "processing"; por eso los clientes normalmente solo ven processing / completed / failed.

Opciones disponibles:
pending,
processing,
completed,
failed
Ejemplo:

"completed"

type
enum<string>

Tipo de tarea

Opciones disponibles:
image,
video,
audio,
text
Ejemplo:

"image"

duration
integer

Duración de la tarea en segundos. Solo está presente cuando status es "completed" o "failed".

Ejemplo:

30

video_duration
number

Duración real del video generado en segundos. Solo está presente en algunos modelos de video (p. ej. Kling) en estado final.

Ejemplo:

5

draft_expires_at
string<date-time>

Fecha límite para convertir el borrador en video final (UTC, RFC 3339). Solo se devuelve cuando un borrador Seedance 2.5 (creado con draft: true) tiene el estado completed. Después de esta fecha ya no se puede convertir mediante Seedance 2.5 Draft-to-Video

Ejemplo:

"2026-09-23T17:19:36Z"

source_task_id
string

ID de la tarea de borrador a partir de la cual se convirtió este video final. Solo se devuelve en tareas Seedance 2.5 Draft-to-Video

Ejemplo:

"task-unified-1774857405-abc123"

results
string<uri>[]

Lista de URL de resultados. Solo está presente cuando status es "completed" y el modelo produce URL; en otro caso el campo no existe.

Ejemplo:
result_data
any

Objeto de resultado completo específico del modelo. En los modelos de imagen es un array de objetos como [{"url": ...}] (las mismas URL que results); algunos modelos devuelven objetos más ricos (p. ej. Suno devuelve objetos de canción). Ausente si el modelo no tiene resultado estructurado.

Ejemplo:
usage
object

Información de uso y facturación. Solo está presente cuando status es "completed". Siempre contiene credits_used y cost; los campos de tokens solo aparecen en modelos facturados por token (p. ej. gpt-image-2). Algunos modelos añaden campos propios.

error
object | null

Información de error cuando la tarea falla (solo presente cuando status es "failed"). Nota: error.code aquí es un código de error de negocio de tipo string, distinto de los códigos de estado HTTP. Consulte la referencia de códigos de error para la lista completa.

task_info
object

Información detallada de la tarea

effective_speed
enum<string>

Midjourney V7 variation / pan / outpaint: prompt es opcional. Si falta, está vacío, contiene solo espacios o solo parámetros controlados de velocidad/versión, se usa Fast y su precio, incluso con speed=turbo. Con texto válido, la velocidad omitida o fast usa Fast; turbo usa Turbo al doble del precio. Playground solo ofrece Fast. La tarea de origen debe estar completada y pertenecer al usuario actual; sin prompt se admiten resultados de generación y de variation, pan y outpaint compatibles. Historical tasks retain their recorded execution speed and billing.

Opciones disponibles:
draft,
fast,
turbo