SeeGen AI API

Aperçu

SeeGen AI est une API de génération unifiée : un ensemble cohérent de points de terminaison pour exécuter plusieurs des principaux modèles d'IA vidéo et image. Choisissez un modèle avec le paramètre model — l'authentification, la soumission des tâches, l'interrogation du statut et les webhooks fonctionnent de la même façon pour tous.

Modèles actuellement disponibles :

• Vidéo — 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)
• Image — 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)

Pourquoi SeeGen AI ?

D'autres raisons de choisir SeeGen AI :

• Plus que Seedance 2.0 : HappyHorse 1.1, Nano Banana, ChatGPT Image, et plus encore.
• Aucun abonnement requis — payez à l'usage
• Accès rapide aux derniers modèles
• Assistance client 24/7
• Assistance pour les questions officielles liées aux modèles
• Accès à la console pour les développeurs
• Ouvert aux entreprises comme aux particuliers

Tarifs

🎉 Offre à durée limitée : 33% de réduction sur toute la génération d'images — tous les prix des images ci-dessous sont déjà réduits.

Consultez votre solde : GET /api/v1/account/credits

Authentification

Toutes les requêtes API nécessitent un jeton Bearer dans l'en-tête Authorization. Vous pouvez créer et gérer vos clés API depuis les Paramètres du compte.

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

Démarrage rapide

Générez une vidéo en deux étapes : créez une tâche, puis interrogez le résultat.

# 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

Points de terminaison

Choisir un modèle (vidéo)

Deux familles de modèles génèrent des vidéos. Choisissez selon le mode et le prix ; combinez avec la section Tarifs pour estimer le coût.

T2V = Texte vers vidéo · I2V = Image vers vidéo (première image) · First–Last = première + dernière image clé · Multi-Ref = références mixtes image / vidéo / audio · R2V = 1 à 9 images de référence avec marqueurs de personnage

Seedance 2.0 / 2.0 Fast / 2.0 Mini / Seedance 2.5

Texte vers vidéo

Génère une vidéo à partir d'un prompt textuel. Aucune image requise.

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

Image vers vidéo

Anime une image statique pour en faire une vidéo. Fournissez une URL d'image comme image de départ.

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

Première et dernière image

Définissez l'image de départ et l'image finale ; le modèle génère la transition entre les deux. Utilise 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-Référence

Utilisez plusieurs images, vidéos et fichiers audio de référence pour guider la génération. Utilise videoInputMode: "reference". Pour sd2.5, il s'agit de la sous-tâche de référence par défaut ; voir Édition et extension vidéo ci-dessous pour éditer ou poursuivre une vidéo existante.

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

Édition et extension vidéo

sd2.5 divise la génération basée sur des références en trois sous-tâches. Omettez mode pour une génération de référence classique, définissez mode: "edit" pour éditer une vidéo existante, ou mode: "extend" pour la prolonger. Les deux nécessitent au moins une vidéo dans videoUrls et produisent toujours une sortie au format d'image de la vidéo source.

Placez la vidéo que vous souhaitez modifier en premier dans videoUrls et désignez-la comme « Video 1 » dans votre prompt. edit force la durée de sortie à correspondre à cette première vidéo (source), qui doit durer entre 4 et 30s ; tout duration envoyé est donc ignoré. La facturation utilise la durée de la vidéo source comme durée de sortie, plus toutes les vidéos de référence en tant qu'entrée. extend accepte 1 à 3 clips assemblés dans l'ordre, et le duration demandé correspond à la durée de sortie de cette génération (sans rapport avec la durée source) — facturé comme une génération de référence classique.

Les modèles de la famille 2.0 (sd2 / sd2-fast / sd2-mini) acceptent aussi mode: "edit" et mode: "extend" : ils déduisent l'opération de votre prompt (décrivez explicitement l'édition ou la poursuite), le format d'image suit la vidéo source, et duration reste sous votre contrôle avec une facturation classique.

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

Référence des paramètres Seedance

Référence complète de tous les paramètres inputs pour les modèles sd2 / sd2-fast / sd2-mini / sd2.5.

Champs de niveau supérieur de la requête : model (obligatoire), inputs (obligatoire), callBackUrl (URL de webhook facultative).

Ressources

Les ressources sont des fichiers image, vidéo et audio qui passent par un processus de vérification avant de pouvoir être utilisés dans des tâches de génération vidéo. Importez une ressource, attendez qu'elle passe à ACTIVE, puis utilisez son URL asset:// dans vos tâches.

Importer une ressource

Deux méthodes d'import : envoyer directement un fichier local (multipart/form-data), ou soumettre une URL HTTPS accessible publiquement. Dans les deux cas, la ressource est traitée et vérifiée automatiquement.

Méthode A — import de fichier direct (multipart/form-data)

Envoyez un fichier local sans besoin d'hébergeur d'images. Le type de média est détecté à partir des octets du fichier (l'extension du nom de fichier n'est pas fiable). Autorisés : images (jpg/png/webp/gif/bmp/tiff/heic), vidéos (mp4/mov), audio (wav/mp3). Max 50MB par fichier (image ≤30MB, vidéo ≤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éthode B — par URL (application/json)

Si le fichier est déjà hébergé à une URL HTTPS publique.

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

Réponse d'import

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

Interroger le statut d'une ressource

Interroge le statut de vérification d'une ressource. Lorsque le statut est PROCESSING, l'endpoint vérifie automatiquement les mises à jour du système de vérification.

# 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"

Lister les ressources

Liste vos ressources importées, avec filtrage facultatif par type et par statut. Prend en charge la pagination par curseur.

# 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"

Réponse de liste

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

Utiliser des ressources dans les tâches

Une fois qu'une ressource est ACTIVE, utilisez son volcAssetId avec le protocole asset:// dans les URL de votre tâche :

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

HappyHorse 1.1 (Alibaba)

Un modèle alternatif de génération vidéo d'Alibaba DashScope. Prend en charge trois modes : texte vers vidéo, image vers vidéo avec première image, et référence vers vidéo (1 à 9 images de référence fusionnées par prompt ; référencez les sujets avec character1, character2, … dans le prompt). HappyHorse 1.1 ne prend pas en charge la dernière image, la vidéo de référence ni l'audio de référence. Nom du modèle : happyhorse.

Aucune vérification de ressource requise — vous pouvez utiliser directement des URL d'images HTTPS publiques, ou passer des références asset:// de la bibliothèque de ressources (résolues automatiquement vers l'URL R2 d'origine).

Texte vers vidéo

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

Image vers vidéo (première image)

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

Référence vers vidéo (1 à 9 images de référence)

Passez videoWorkflowTab: "multi-reference" avec 1 à 9 URL d'images de référence pour fusionner plusieurs sujets en une seule sortie. Référencez chaque image dans le prompt avec character1, character2, … (dans l'ordre de urls). Le format d'image est contrôlé par le champ ratio (il n'y a pas de première image pour le déduire).

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

Référence des paramètres HappyHorse

Référence complète de tous les paramètres inputs pour le modèle happyhorse.

Choisir un modèle (image)

Les modèles d'image prennent un prompt (et éventuellement des images de référence) et renvoient une image par tâche. Chaque requête est facturée par image selon le niveau du modèle sélectionné (ou un tarif forfaitaire pour Seedream Lite). Les tâches échouées sont remboursées automatiquement. Il n'y a pas de paramètre de lot — pour générer plusieurs variantes, appelez createTask une fois par image.

GPT Image 2

Le modèle GPT Image 2 d'OpenAI pour l'édition texte vers image et image vers image de haute qualité. Un seul workflow gère les deux modes — passez urls pour basculer automatiquement en mode édition. La sortie est livrée via R2 dans le format demandé (PNG / JPEG / WEBP). Nom du modèle : gpt-image-2.

Texte vers image

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

Image vers image (édition)

Passez de 1 à 10 images de référence via urls. Le modèle les utilisera comme contexte visuel pour l'édition décrite dans 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

Référence des paramètres GPT Image 2

Référence complète de tous les paramètres inputs pour le modèle gpt-image-2.

Les crédits par image varient selon la résolution et la qualité — consultez le tableau complet dans la section Tarifs.

Nano Banana 2

Nano Banana 2 est un modèle d'image haute fidélité offrant une couverture de formats plus large que gpt-image-2 — il ajoute des préréglages portrait/paysage (3:2, 2:3, 4:5, 5:4) et le format cinématographique 21:9. Un seul workflow gère les deux modes — passez urls pour basculer automatiquement en mode édition. Nom du modèle : nano-banana-2.

Texte vers image

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

Image vers image (édition)

Passez de 1 à 10 images de référence via urls. Le modèle les utilisera comme contexte visuel pour l'édition décrite dans 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

Référence des paramètres Nano Banana 2

Référence complète de tous les paramètres inputs pour le modèle nano-banana-2.

Les crédits par image varient selon la résolution — consultez le tableau complet dans la section Tarifs.

Nano Banana Pro

Nano Banana Pro est un modèle d'image haute fidélité offrant une couverture de formats plus large que gpt-image-2 — il ajoute des préréglages portrait/paysage (3:2, 2:3, 4:5, 5:4) et le format cinématographique 21:9. Un seul workflow gère les deux modes — passez urls pour basculer automatiquement en mode édition. Nom du modèle : nano-banana-pro.

Texte vers image

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

Image vers image (édition)

Passez de 1 à 10 images de référence via urls. Le modèle les utilisera comme contexte visuel pour l'édition décrite dans 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

Référence des paramètres Nano Banana Pro

Référence complète de tous les paramètres inputs pour le modèle nano-banana-pro.

Les crédits par image varient selon la résolution — consultez le tableau complet dans la section Tarifs.

Seedream 5.0 Lite

Génération rapide texte vers image et image vers image en 2K ou 4K avec 15 formats d'image. Nom du modèle : seedream-v5.0-lite.

Texte vers image

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

Image vers image (édition)

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

Paramètres Seedream 5.0 Lite

Seedream 5.0 Pro

Génération et édition haute fidélité en 1K ou 2K. Nom du modèle : seedream-v5.0-pro.

Texte vers image

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

Image vers image (édition)

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

Paramètres Seedream 5.0 Pro

Upscaler vidéo

Créer une tâche

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

Réponse de création

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

Interroger le statut

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

Le statut progresse validating → processing → completed / failed.

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

Réponse en cas de succès

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

Réponse en cas d'échec

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

Codes d'erreur

Erreurs courantes sur lesquelles vous pouvez agir. Les autres échecs renvoient un champ message explicite — lisez-le avant de supposer que le code en fait partie.

Callback webhook

Au lieu d'interroger l'API, vous pouvez fournir une callBackUrl pour recevoir automatiquement les résultats lorsqu'une tâche se termine ou échoue.

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 du callback

Une fois la tâche terminée, nous envoyons une requête POST à votre URL avec le même format que la réponse 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
}

Format de réponse

Réponse de createTask

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

Réponse 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
}

Réponse de credits

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

Gestion des erreurs

Validation avant soumission (400 avec un code)

Les requêtes Seedance sont vérifiées par rapport au contrat en amont avant que le moindre crédit ne soit facturé. Lorsqu'une vérification échoue, createTask renvoie { "message": "...", "code": "..." } avec un statut HTTP 400, et aucune tâche n'est créée. Le message indique précisément quelle limite a été dépassée et comment la corriger.

Exemples complets

Workflow complet : importez une ressource, attendez la vérification, créez une tâche avec la ressource approuvée, puis interrogez le résultat.

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);