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.5 (sd2.5), Seedance 2.0 Pro (sd2), Fast (sd2-fast), Mini (sd2-mini), Wan 3.0 Video Prime (wan3.0-video-prime), Wan 3.0 Video (wan3.0-video)
• 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 : Wan 3.0, 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

Recharge automatique pour les comptes API

Votre clé API et le tableau de bord SeeGen AI utilisent le même solde de crédits au niveau du compte. La recharge automatique permet de maintenir un solde disponible pour les charges de travail API, mais elle doit être configurée depuis la page Credits ; il n’existe actuellement aucune API de configuration distincte.

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)

Choisissez un modèle vidéo selon le workflow, la résolution native, la vitesse et le prix ; combinez ce tableau 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",
      "videoInputMode": "reference",
      "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 Seedance

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

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

Wan 3.0 Video et Wan 3.0 Video Prime

Wan 3.0 prend en charge la vidéo à partir de texte ou d’une première image, l’interpolation entre première et dernière images, les références mixtes image/vidéo/audio, la modification et la prolongation vidéo. wan3.0-video-prime accepte les mêmes entrées que wan3.0-video et est optimisé pour une génération plus rapide.

Les deux alias utilisent l’API asynchrone de SeeGen : POST /api/v1/jobs/createTask renvoie un taskId ; interrogez GET /api/v1/jobs/queryTask?taskId=... ou fournissez callBackUrl pour obtenir le résultat final.

Sortie prise en charge : durées fixes de 2–30 secondes en 480p, 720p ou 1080p natifs, sans filigrane. La durée automatique (duration: -1), la sortie 2K/4K et le réglage personnalisé de watermark ne sont pas pris en charge. Importez d’abord les médias de référence, puis utilisez l’URL HTTPS renvoyée.

Texte vers vidéo

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "inputs": {
      "prompt": "A red paper boat glides across a calm pond at sunrise, locked camera, no text.",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9",
      "generateAudio": true,
      "promptExtend": true,
      "seed": 12345
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image vers vidéo (première image)

Importez les médias Wan via multipart POST /api/v1/assets/upload?model=wan3.0-video (ou l’alias Prime), puis utilisez l’url HTTPS renvoyée qui vous appartient dans les entrées de génération. L’assetId renvoyé est uniquement l’identifiant de l’enregistrement média SeeGen ; ne l’envoyez pas dans les entrées de génération.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@/path/to/first-frame.webp" \
  "https://seegen.ai/api/v1/assets/upload?model=wan3.0-video"

{
  "assetId": 123,
  "type": "IMAGE",
  "status": "ACTIVE",
  "url": "https://static.seegen.ai/materials/api/.../first-frame.webp"
}

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "inputs": {
      "urls": ["https://static.seegen.ai/materials/api/.../first-frame.webp"],
      "videoInputMode": "keyframe",
      "prompt": "The subject looks toward the camera as morning mist drifts past.",
      "duration": "5s",
      "outputResolution": "1080p",
      "generateAudio": true
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Première et dernière image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "inputs": {
      "urls": [
        "https://static.seegen.ai/materials/api/.../first-frame.webp",
        "https://static.seegen.ai/materials/api/.../last-frame.webp"
      ],
      "videoInputMode": "keyframe",
      "prompt": "A smooth continuous transition from sunrise to night.",
      "duration": "8s",
      "outputResolution": "720p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Références multiples (images, vidéos et audio)

Définissez videoInputMode: "reference", puis fournissez au moins un média pris en charge via urls, videoUrls ou audioUrls ; le prompt est facultatif. Référencez les médias dans l’ordre avec Image1, Image2, Video1 ou Audio1. Importez d’abord chaque référence via l’endpoint multipart de Wan, puis utilisez l’URL HTTPS renvoyée qui vous appartient.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "inputs": {
      "videoInputMode": "reference",
      "urls": ["https://static.seegen.ai/materials/api/.../reference-image.webp"],
      "videoUrls": ["https://static.seegen.ai/materials/api/.../source-video.mp4"],
      "audioUrls": ["https://static.seegen.ai/materials/api/.../reference-audio.mp3"],
      "prompt": "Use Image1 for identity, Video1 for motion, and Audio1 for timing.",
      "duration": "10s",
      "outputResolution": "720p",
      "ratio": "16:9",
      "generateAudio": true,
      "promptExtend": true
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Montage vidéo

Importez d’abord la vidéo source, puis utilisez mode: "edit" avec videoInputMode: "reference". Dans le prompt obligatoire, décrivez comment modifier Video1, la première vidéo de videoUrls. Le format d’image est automatique ; vous choisissez la durée de sortie. Les limites des références et les tarifs ci-dessous s’appliquent à la modification comme à la prolongation.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "inputs": {
      "mode": "edit",
      "videoInputMode": "reference",
      "videoUrls": ["https://static.seegen.ai/materials/api/.../source-video.mp4"],
      "prompt": "Transform Video1 into clay animation, keeping the characters and camera movement.",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "adaptive"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Extension vidéo

Utilisez mode: "extend" avec une vidéo source et une consigne, comme « Prolonge Video1 vers la suite », suivie de ce qui se passe ensuite. Définissez ratio: "adaptive". La valeur duration est la durée de la vidéo générée, pas la somme de la source et de la prolongation. La génération depuis des fichiers ou des pages web n’est pas prise en charge.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "inputs": {
      "mode": "extend",
      "videoInputMode": "reference",
      "videoUrls": ["https://static.seegen.ai/materials/api/.../source-video.mp4"],
      "prompt": "Extend Video1 forward, continuing the motion of the character and keeping the scene consistent.",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "adaptive"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Référence des paramètres de Wan 3.0

Les deux modèles Wan 3.0 acceptent les mêmes champs inputs. Choisissez une durée de sortie de 2 à 30 secondes, par incréments d’une seconde.

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.5 Flare / Sunburst

GPT Image 2.5 Flare privilégie la rapidité de génération et de retouche. Sunburst privilégie les images détaillées et les retouches précises. Tous deux acceptent des prompts textuels et des images de référence.

Disponible dans l’espace de travail, Playground et via l’API. Les deux modèles acceptent les paramètres suivants : qualité medium/high/xhigh/max, préréglages 1K/2K/4K et sorties PNG/JPEG/WebP. Les dimensions réelles peuvent différer du préréglage. Les fichiers JPEG et WebP sont convertis à partir du PNG généré, sans redimensionnement. Chaque tâche API génère une image.

Texte vers image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "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.5-sunburst",
    "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.5

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

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

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 et Wan 3.0 sont vérifiées selon les règles produit de SeeGen avant tout débit de crédits. En cas d’échec, createTask renvoie HTTP 400 avec { "message": "...", "code": "..." } ; les erreurs Wan peuvent aussi contenir un path. Aucune tâche n’est créée ni facturée.

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