SeeGen AI API

Descripción general

SeeGen AI es una API de generación unificada: un conjunto consistente de endpoints para ejecutar varios de los principales modelos de IA de vídeo e imagen. Elige un modelo con el parámetro model — la autenticación, el envío de tareas, el sondeo de estado y los webhooks funcionan igual en todos ellos.

Modelos disponibles actualmente:

• Vídeo — Seedance 2.0 Pro (sd2), Seedance 2.0 Fast (sd2-fast), Seedance 2.0 Mini (sd2-mini), Seedance 2.5 (sd2.5), HappyHorse 1.1 (happyhorse)
• Imagen — GPT Image 2 (gpt-image-2), Nano Banana 2 (nano-banana-2), Nano Banana Pro (nano-banana-pro), Seedream 5.0 Lite (seedream-v5.0-lite), Seedream 5.0 Pro (seedream-v5.0-pro)

¿Por qué SeeGen AI?

Más razones para elegir SeeGen AI:

• Más que Seedance 2.0: HappyHorse 1.1, Nano Banana, ChatGPT Image y más.
• Sin suscripción — paga solo por lo que uses
• Acceso rápido a los modelos más recientes
• Soporte al cliente 24/7
• Soporte para consultas oficiales relacionadas con los modelos
• Acceso a la consola para desarrolladores
• Abierto tanto a empresas como a usuarios individuales

Precios

🎉 Oferta por tiempo limitado: 33% de descuento en toda la generación de imágenes — todos los precios de imagen que aparecen abajo ya incluyen el descuento.

Consulta tu saldo: GET /api/v1/account/credits

Autenticación

Todas las solicitudes a la API requieren un token Bearer en la cabecera Authorization. Puedes crear y gestionar tus claves de API desde Configuración de la cuenta.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://seegen.ai/api/v1/account/credits

Guía rápida

Genera un vídeo en dos pasos: crea una tarea y luego consulta el resultado.

# 1. Create a text-to-video task
TASK_ID=$(curl -s -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "prompt": "A golden retriever running on the beach at sunset",
      "duration": "5s",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask | jq -r '.taskId')

echo "Task created: $TASK_ID"

# 2. Poll for result
while true; do
  RESULT=$(curl -s -H "Authorization: Bearer $API_KEY" \
    "https://seegen.ai/api/v1/jobs/queryTask?taskId=$TASK_ID")
  STATUS=$(echo $RESULT | jq -r '.status')
  echo "Status: $STATUS"
  if [ "$STATUS" = "COMPLETED" ] || [ "$STATUS" = "FAILED" ]; then
    echo $RESULT | jq .
    break
  fi
  sleep 5
done

Endpoints

Elegir un modelo (vídeo)

Dos familias de modelos generan vídeo. Elige según el modo y el precio; combina con la sección Precios para estimar el coste.

T2V = Texto a vídeo · I2V = Imagen a vídeo (primer fotograma) · First–Last = primer + último fotograma clave · Multi-Ref = referencias mixtas de imagen / vídeo / audio · R2V = 1–9 imágenes de referencia con marcadores de personaje

Seedance 2.0 / 2.0 Fast / 2.0 Mini / Seedance 2.5

Texto a vídeo

Genera un vídeo a partir de un prompt de texto. No se requieren imágenes.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "prompt": "A futuristic city with flying cars at night, neon lights reflecting on wet streets",
      "duration": "5s",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a vídeo

Anima una imagen estática convirtiéndola en un vídeo. Proporciona una URL de imagen como fotograma inicial.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": ["https://example.com/photo.jpg"],  // or "asset://asset-20260326-abc123"
      "prompt": "The woman slowly turns her head and smiles",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Primer y último fotograma

Define el fotograma inicial y el final, y el modelo genera la transición entre ambos. Usa videoInputMode: "keyframe".

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": [
        "https://example.com/first-frame.jpg",
        "https://example.com/last-frame.jpg"
      ],
      "prompt": "Smooth camera transition from day to night",
      "duration": "5s",
      "videoInputMode": "keyframe"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Multi-Referencia

Usa varias imágenes, vídeos y archivos de audio de referencia para guiar la generación. Usa videoInputMode: "reference". En sd2.5 esta es la subtarea de referencia por defecto; consulta Edición y extensión de vídeo más abajo para editar o continuar un vídeo existente.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      "videoUrls": ["asset://asset-motion-video"],
      "audioUrls": ["https://example.com/audio.mp3"],
      "prompt": "Character walks through a garden",
      "duration": "5s",
      "videoInputMode": "reference",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Edición y extensión de vídeo

sd2.5 divide la generación basada en referencias en tres subtareas. Omite mode para la generación de referencia habitual, define mode: "edit" para editar un vídeo existente, o mode: "extend" para continuarlo. Ambas requieren al menos un vídeo en videoUrls y siempre generan la salida con la relación de aspecto del vídeo de origen.

Coloca el vídeo que quieres modificar en primer lugar dentro de videoUrls y refiérete a él como "Video 1" en tu prompt. edit obliga a que la duración de salida coincida con ese primer vídeo (de origen), que debe durar entre 4 y 30s, por lo que se ignora cualquier duration que envíes; la facturación usa la duración del vídeo de origen como duración de salida, más todos los vídeos de referencia como entrada. extend acepta de 1 a 3 clips unidos en orden, y el duration que solicites es la duración de salida de esta generación (sin relación con la duración de origen), facturado como una generación de referencia normal.

Los modelos de la familia 2.0 (sd2 / sd2-fast / sd2-mini) también admiten mode: "edit" y mode: "extend": infieren la operación a partir de tu prompt (describe explícitamente la edición o continuación), la relación de aspecto sigue al vídeo de origen, y duration sigue bajo tu control con la facturación habitual.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2.5",
    "inputs": {
      "mode": "edit",
      "videoUrls": ["asset://asset-source-video"],
      "urls": ["https://example.com/annotation-at-1.2s.png"],
      "source_frame_timestamps_ms": [1200],
      "prompt": "Replace the marked object with a red umbrella",
      "outputResolution": "720p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referencia de parámetros de Seedance

Referencia completa de todos los parámetros de inputs para los modelos sd2 / sd2-fast / sd2-mini / sd2.5.

Campos de nivel superior de la solicitud: model (obligatorio), inputs (obligatorio), callBackUrl (URL de webhook opcional).

Recursos

Los recursos son archivos de imagen, vídeo y audio que pasan por un proceso de revisión antes de poder usarse en tareas de generación de vídeo. Sube un recurso, espera a que pase a ACTIVE y luego usa su URL asset:// en tus tareas.

Subir recurso

Hay dos formas de subir: enviar un archivo local directamente (multipart/form-data) o enviar una URL HTTPS de acceso público. En ambos casos, el recurso se procesa y revisa automáticamente.

Método A: subida de archivo directa (multipart/form-data)

Envía un archivo local sin necesidad de alojar la imagen en otro sitio. El tipo de medio se detecta a partir de los bytes del archivo (no se confía en la extensión del nombre). Permitidos: imágenes (jpg/png/webp/gif/bmp/tiff/heic), vídeos (mp4/mov), audio (wav/mp3). Máximo 50MB por archivo (imagen ≤30MB, vídeo ≤50MB, audio ≤15MB).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@/path/to/photo.jpg" \
  -F "name=my-photo" \
  https://seegen.ai/api/v1/assets/upload

Método B: por URL (application/json)

Si el archivo ya está alojado en una URL HTTPS pública.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "type": "IMAGE",
    "name": "my-photo"
  }' \
  https://seegen.ai/api/v1/assets/upload

Respuesta de subida

{
  "assetId": 123,
  "volcAssetId": "asset-20260326-abc123",
  "type": "IMAGE",
  "status": "PROCESSING",
  "failReason": null,
  "url": "https://example.com/photo.jpg",
  "name": "my-photo",
  "createdAt": 1711234567890
}

Consultar estado del recurso

Consulta el estado de revisión de un recurso. Cuando el estado es PROCESSING, el endpoint comprueba automáticamente si hay actualizaciones del sistema de revisión.

# Query by asset ID (numeric)
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/status?assetId=123"

# Query by volcAssetId (string)
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/status?assetId=asset-20260326-abc123"

Listar recursos

Enumera tus recursos subidos, con filtrado opcional por tipo y estado. Admite paginación basada en cursor.

# List all assets
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list"

# Filter by type and status
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list?type=IMAGE&status=ACTIVE&limit=10"

# Paginate with cursor
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list?cursor=100&limit=20"

Respuesta de listado

{
  "items": [
    {
      "assetId": 123,
      "volcAssetId": "asset-20260326-abc123",
      "type": "IMAGE",
      "status": "ACTIVE",
      "failReason": null,
      "url": "https://example.com/photo.jpg",
      "name": "my-photo",
      "width": 1920,
      "height": 1080,
      "size": 245000,
      "duration": null,
      "createdAt": 1711234567890
    }
  ],
  "nextCursor": 122
}

Uso de recursos en tareas

Una vez que un recurso está ACTIVE, usa su volcAssetId con el protocolo asset:// en las URLs de tu tarea:

{
  "model": "sd2",
  "inputs": {
    "urls": ["asset://asset-20260326-abc123"],
    "prompt": "The person slowly looks up and smiles",
    "duration": "5s"
  }
}

HappyHorse 1.1 (Alibaba)

Un modelo alternativo de generación de vídeo de Alibaba DashScope. Admite tres modos: texto a vídeo, imagen a vídeo con primer fotograma, y referencia a vídeo (1–9 imágenes de referencia fusionadas por prompt; haz referencia a los sujetos con character1, character2, … en el prompt). HappyHorse 1.1 no admite último fotograma, vídeo de referencia ni audio de referencia. Nombre del modelo: happyhorse.

No requiere revisión de recursos — puedes usar URLs de imagen HTTPS públicas directamente, o pasar referencias asset:// de la biblioteca de recursos (se resuelven automáticamente a la URL R2 original).

Texto a vídeo

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "prompt": "A panda DJ at a beach party, smoky sunset",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a vídeo (primer fotograma)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "urls": ["https://example.com/panda.jpg"],
      "prompt": "The panda blinks and smiles",
      "duration": "5s",
      "outputResolution": "1080p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referencia a vídeo (1–9 imágenes de referencia)

Pasa videoWorkflowTab: "multi-reference" con 1–9 URLs de imágenes de referencia para fusionar varios sujetos en una sola salida. Haz referencia a cada imagen en el prompt con character1, character2, … (siguiendo el orden de urls). La relación de aspecto se controla con el campo ratio (no hay un primer fotograma del que derivarla).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "videoWorkflowTab": "multi-reference",
      "urls": [
        "https://example.com/character.jpg",
        "https://example.com/folding-fan.jpg",
        "https://example.com/earrings.jpg"
      ],
      "prompt": "A woman in red character1 opening folding fan character2, with tassel earrings character3 swinging",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referencia de parámetros de HappyHorse

Referencia completa de todos los parámetros de inputs para el modelo happyhorse.

Elegir un modelo (imagen)

Los modelos de imagen toman un prompt (y opcionalmente imágenes de referencia) y devuelven una imagen por tarea. Cada solicitud se factura por imagen según el nivel del modelo seleccionado (o una tarifa fija para Seedream Lite). Las tareas fallidas se reembolsan automáticamente. No hay parámetro de lote — para generar varias variantes, llama a createTask una vez por imagen.

GPT Image 2

El modelo GPT Image 2 de OpenAI para edición de texto a imagen e imagen a imagen de alta calidad. Un único flujo de trabajo gestiona ambos modos — pasa urls para cambiar automáticamente al modo de edición. La salida se entrega mediante R2 en el formato que solicites (PNG / JPEG / WEBP). Nombre del modelo: gpt-image-2.

Texto a imagen

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "quality": "medium",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a imagen (edición)

Pasa de 1 a 10 imágenes de referencia mediante urls. El modelo las usará como contexto visual para la edición descrita en prompt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "quality": "medium",
      "resolution": "1k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referencia de parámetros de GPT Image 2

Referencia completa de todos los parámetros de inputs para el modelo gpt-image-2.

Los créditos por imagen varían según la resolución y la calidad — consulta la tabla completa en la sección Precios.

Nano Banana 2

Nano Banana 2 es un modelo de imagen de alta fidelidad con mayor cobertura de relaciones de aspecto que gpt-image-2 — añade preajustes vertical/horizontal (3:2, 2:3, 4:5, 5:4) y el formato cinematográfico 21:9. Un único flujo de trabajo gestiona ambos modos — pasa urls para cambiar automáticamente al modo de edición. Nombre del modelo: nano-banana-2.

Texto a imagen

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a imagen (edición)

Pasa de 1 a 10 imágenes de referencia mediante urls. El modelo las usará como contexto visual para la edición descrita en prompt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referencia de parámetros de Nano Banana 2

Referencia completa de todos los parámetros de inputs para el modelo nano-banana-2.

Los créditos por imagen varían según la resolución — consulta la tabla completa en la sección Precios.

Nano Banana Pro

Nano Banana Pro es un modelo de imagen de alta fidelidad con mayor cobertura de relaciones de aspecto que gpt-image-2 — añade preajustes vertical/horizontal (3:2, 2:3, 4:5, 5:4) y el formato cinematográfico 21:9. Un único flujo de trabajo gestiona ambos modos — pasa urls para cambiar automáticamente al modo de edición. Nombre del modelo: nano-banana-pro.

Texto a imagen

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a imagen (edición)

Pasa de 1 a 10 imágenes de referencia mediante urls. El modelo las usará como contexto visual para la edición descrita en prompt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Referencia de parámetros de Nano Banana Pro

Referencia completa de todos los parámetros de inputs para el modelo nano-banana-pro.

Los créditos por imagen varían según la resolución — consulta la tabla completa en la sección Precios.

Seedream 5.0 Lite

Generación rápida de texto a imagen e imagen a imagen en 2K o 4K con 15 relaciones de aspecto. Nombre del modelo: seedream-v5.0-lite.

Texto a imagen

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-lite",
    "inputs": {
      "prompt": "A cinematic product photograph, soft studio light",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a imagen (edición)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-lite",
    "inputs": {
      "prompt": "Restyle the references as a premium fashion campaign",
      "urls": ["https://example.com/reference.png"],
      "resolution": "4k",
      "aspectRatio": "3:4"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Parámetros de Seedream 5.0 Lite

Seedream 5.0 Pro

Generación y edición de alta fidelidad en 1K o 2K. Nombre del modelo: seedream-v5.0-pro.

Texto a imagen

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-pro",
    "inputs": {
      "prompt": "Editorial portrait with dramatic rim lighting",
      "resolution": "2k",
      "aspectRatio": "3:4"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Imagen a imagen (edición)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-pro",
    "inputs": {
      "prompt": "Turn the reference into a cinematic poster",
      "urls": ["https://example.com/reference.png"],
      "resolution": "2k",
      "aspectRatio": "1:2"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Parámetros de Seedream 5.0 Pro

Escalador de vídeo

Crear tarea

POST /api/v1/upscale/create

# source.url accepts ANY https video URL — your own CDN, OR a file you first
# uploaded to us via /api/v1/assets/upload (pass the r2Url it returns). No need
# to declare which: we detect it. External URLs are validated; our own are trusted.
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "type": "url", "url": "https://your-cdn.com/video.mp4" },
    "targetResolution": "2k",
    "callBackUrl": "https://your-server.com/webhook"
  }' \
  https://seegen.ai/api/v1/upscale/create

Respuesta de creación

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "orderId": "ord_2026...",
  "status": "validating"
}

Consultar estado

GET /api/v1/upscale/query?taskId=...

El estado avanza validating → processing → completed / failed.

curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/upscale/query?taskId=n770mo4sh6rpi690ff3gwymx"

Respuesta de finalización

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "status": "completed",
  "targetResolution": "2k",
  "creditsConsumed": 900,
  "result": {
    "url": "https://static.seegen.ai/standalone-upscale/results/...mp4",
    "probedDurationSeconds": 30,
    "probedSourceResolution": "1280x720"
  },
  "error": null,
  "createdAt": "2026-04-29T01:23:45.000Z",
  "finishedAt": "2026-04-29T01:35:01.000Z"
}

Respuesta de fallo

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "status": "failed",
  "creditsConsumed": null,
  "result": null,
  "error": {
    "code": "SOURCE_RESOLUTION_TOO_HIGH",
    "message": "Source 3840x2160 is not below target 4k"
  }
}

Códigos de error

Errores comunes sobre los que puedes actuar. Otros fallos devuelven un campo message autoexplicativo — léelo antes de asumir que el código es uno de estos.

Callback de webhook

En lugar de hacer polling, puedes proporcionar una callBackUrl para recibir los resultados automáticamente cuando una tarea se completa o falla.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "callBackUrl": "https://your-server.com/webhook/callback",
    "inputs": {
      "prompt": "A cat playing piano",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Payload del callback

Cuando la tarea finaliza, enviamos una solicitud POST a tu URL con el mismo formato que la respuesta de queryTask:

// POST to your callBackUrl
{
  "taskId": "task_abc123",
  "model": "sd2",
  "status": "COMPLETED",
  "creditsUsed": 200,
  "output": [
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

Formato de respuesta

Respuesta de createTask

// 200 OK
{ "taskId": "task_abc123" }

Respuesta de queryTask

{
  "taskId": "task_abc123",
  "model": "sd2",
  "status": "COMPLETED",     // "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED"
  "creditsUsed": 200,
  "output": [                // null when status is not "COMPLETED"
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,             // error message when status is "FAILED"
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

Respuesta de credits

{
  "credits": 5000,
  "availableCredits": 4800
}

Manejo de errores

Validación previa al envío (400 con un código)

Las solicitudes de Seedance se verifican contra el contrato ascendente antes de cobrar cualquier crédito. Cuando una verificación falla, createTask devuelve { "message": "...", "code": "..." } con HTTP 400 y no se crea ninguna tarea. El mensaje indica exactamente qué límite se superó y cómo solucionarlo.

Ejemplos completos

Flujo de trabajo completo: sube un recurso, espera la revisión, crea una tarea con el recurso aprobado y consulta el resultado.

const API_KEY = process.env.API_KEY;
const BASE = "https://seegen.ai/api/v1";
const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Upload asset and wait for review
// (To upload a LOCAL file instead of a URL, POST multipart/form-data with a "file"
//  field — no Content-Type header, no "type" — see the Upload Asset section above.)
async function uploadAndWaitForAsset(url, type = "IMAGE") {
  const res = await fetch(`${BASE}/assets/upload`, {
    method: "POST",
    headers,
    body: JSON.stringify({ url, type }),
  });
  if (!res.ok) throw new Error(`Upload failed: ${(await res.json()).message}`);
  const asset = await res.json();
  console.log(`Asset uploaded: ${asset.assetId}, status: ${asset.status}`);

  // Poll until review completes
  while (true) {
    const statusRes = await fetch(
      `${BASE}/assets/status?assetId=${asset.assetId}`,
      { headers }
    );
    const status = await statusRes.json();
    if (status.status === "ACTIVE") {
      console.log(`Asset approved: asset://${status.volcAssetId}`);
      return status.volcAssetId;
    }
    if (status.status === "FAILED") {
      throw new Error(`Asset review failed: ${status.failReason}`);
    }
    await new Promise((r) => setTimeout(r, 3000));
  }
}

// 2. Create a task
async function createTask(inputs, callBackUrl) {
  const res = await fetch(`${BASE}/jobs/createTask`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      model: "sd2",
      inputs,
      ...(callBackUrl && { callBackUrl }),
    }),
  });
  if (!res.ok) throw new Error(`[${res.status}] ${(await res.json()).message}`);
  return res.json();
}

// 3. Poll until done
async function waitForResult(taskId, timeoutMs = 300000) {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const res = await fetch(
      `${BASE}/jobs/queryTask?taskId=${taskId}`,
      { headers }
    );
    const result = await res.json();
    if (result.status === "COMPLETED") return result;
    if (result.status === "FAILED") throw new Error(result.error);
    await new Promise((r) => setTimeout(r, 5000));
  }
  throw new Error("Timeout waiting for task");
}

// Full workflow: upload → review → generate → result
async function main() {
  // Upload image and wait for review
  const volcAssetId = await uploadAndWaitForAsset(
    "https://example.com/photo.jpg", "IMAGE"
  );

  // Create task with approved asset
  const { taskId } = await createTask({
    urls: [`asset://${volcAssetId}`],
    prompt: "The person slowly looks up and smiles",
    duration: "5s",
  });
  console.log(`Task: ${taskId}`);

  // Wait for video
  const result = await waitForResult(taskId);
  console.log(`Video: ${result.output[0].url}`);
}

main().catch(console.error);