Référence API de Seedream 5.0 Pro

Une seule clé API PopNow suffit pour appeler Seedream 5.0 Pro 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: 5.4 crédits par image ($0.054)
Durée habituelle: environ 54 s
Identifiants de modèle: bytedance/seedream-5.0-pro/text-to-image
bytedance/seedream-5.0-pro/edit
bytedance/seedream-5.0-pro/layer-decomposition

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-pro/text-to-image

Prix

Option	Crédits (par image)	Dollars US
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 5 000 caractères	Describe the image to generate: subject, composition, style, and lighting.
`aspect_ratio`Facultatif	`string`	`1:1`	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, 3:1, … (+1)	Output aspect ratio.
`resolution`Facultatif	`string`	`2k`	1k, 2k	Output resolution tier.
`output_format`Facultatif	`string`	`jpeg`	jpeg, png	File format of the returned image.
`enable_thinking`Facultatif	`boolean`	`true`	—	Run a thinking pass that refines the prompt before generating. Off is faster.

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

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-pro/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",
    "resolution": "2k"
  }
}'

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-pro/edit

Prix

Option	Crédits (par image)	Dollars US
`1k`	5.4	$0.054
`2k`	10.8	$0.108

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 5 000 caractères	Describe the image to produce from the source: subject, composition, style, and lighting.
`image_urls`Obligatoire	`array<string (uri)>`	—	jusqu’à 10 éléments	Source images that you are authorised to process.
`aspect_ratio`Facultatif	`string`	`auto`	auto, 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 picks the supported ratio closest to the first reference image.
`resolution`Facultatif	`string`	`2k`	1k, 2k	Output resolution tier.
`output_format`Facultatif	`string`	`jpeg`	jpeg, png	File format of the returned image.
`background`Facultatif	`string`	`opaque`	opaque, transparent	Opaque image, or a PNG with a transparent background (png output, one PNG input with alpha).
`enable_thinking`Facultatif	`boolean`	`true`	—	Run a thinking pass that refines the prompt before generating. Off is faster.

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

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-pro/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"
    ],
    "resolution": "2k"
  }
}'

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-pro/layer-decomposition

Prix

Option	Crédits (par image)	Dollars US
`1.5k`	6.3	$0.063
`1k`	6.3	$0.063
`2k`	12.6	$0.126
`auto`	12.6	$0.126

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`image_url`Obligatoire	`string (uri)`	—	—	The finished image to split into layers.
`prompt`Facultatif	`string`	—	jusqu’à 5 000 caractères	Optional: name the elements to separate. Leave empty to let the model pick the main elements.
`resolution`Facultatif	`string`	`1.5k`	auto, 1k, 1.5k, 2k	Output resolution tier. auto follows the size of the source image.
`output_format`Facultatif	`string`	`jpeg`	jpeg, png	File 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-pro/layer-decomposition",
  "input": {
    "prompt": "A bright, cheerful scene with soft natural light",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1.5k"
  }
}'

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"

Référence API de Seedream 5.0 Pro

En bref

Créer une image

Prix

Paramètres

Exemple de requête

Modifier une image

Prix

Paramètres

Exemple de requête

Séparer les calques

Prix

Paramètres

Exemple de requête

Pour aller plus loin

Sur cette page