PopNowDocs API
Contenu principal

Référence API de Seedream 5.0 Flash

Seedream rapide : images, retouches et calques jusqu’en 2K

Une seule clé API PopNow suffit pour appeler Seedream 5.0 Flash depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur
ByteDance
Résultat
Image
À partir de
3.9 crédits par image ($0.039)
Durée habituelle
environ 31 s

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Créer une image

bytedance/seedream-5.0-flash/text-to-image

Prix

OptionCrédits (par image)Dollars US
Par défaut4.35$0.0435

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
promptObligatoirestring—jusqu’à 5 000 caractèresDescribe the image to generate: subject, composition, style, lighting and any exact text.
aspect_ratioFacultatifstring1:11:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2, 3:1, … (+1)Output aspect ratio.
resolutionFacultatifstring2k1k, 1.5k, 2kOutput resolution tier. All three tiers cost the same.
output_formatFacultatifstringjpegjpeg, pngFile format of the returned image.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-flash/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Modifier une image

bytedance/seedream-5.0-flash/edit

Prix

OptionCrédits (par image)Dollars US
Par défaut4.35$0.0435

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
promptObligatoirestring—jusqu’à 5 000 caractèresDescribe the image to produce from the references, and what each reference contributes.
image_urlsObligatoirearray<string (uri)>—jusqu’à 10 élémentsOne to ten reference images that you are authorised to process.
aspect_ratioFacultatifstringautoauto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2, … (+2)Output aspect ratio. auto keeps the shape of the first reference image.
resolutionFacultatifstring2k1k, 1.5k, 2kOutput resolution tier. All three tiers cost the same.
output_formatFacultatifstringjpegjpeg, pngFile format of the returned image.
backgroundFacultatifstringopaqueopaque, transparentOpaque image, or a PNG with a transparent background (png output, one PNG input with alpha).

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-flash/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ]
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Séparer les calques

bytedance/seedream-5.0-flash/layer-decomposition

Prix

OptionCrédits (par image)Dollars US
Par défaut3.9$0.039

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
image_urlObligatoirestring (uri)——The finished image to split into layers.
promptFacultatifstring—jusqu’à 5 000 caractèresOptional: name the elements to separate. Leave empty to let the model pick the main elements.
resolutionFacultatifstringautoauto, 1k, 1.5k, 2kOutput resolution tier. auto follows the size of the source image.
output_formatFacultatifstringjpegjpeg, pngFile format of the base image. Layers are always transparent PNG.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-5.0-flash/layer-decomposition",
  "input": {
    "prompt": "A bright, cheerful scene with soft natural light",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Pour aller plus loin

Sur cette page