Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
aspect_ratio | Non | La forme du cadre : large, carrée ou verticale. 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 · 3:1 · 1:3 · Par défaut: auto |
background | Non | Garder, supprimer ou remplacer l’arrière-plan. opaque · transparent · Par défaut: opaque |
image_urls | Oui | Les photos à retoucher ou combiner. Dites dans le prompt ce que chacune apporte. |
output_format | Non | Le type de fichier du résultat. jpeg · png · Par défaut: jpeg |
prompt | Oui | Describe the image to produce from the references, and what each reference contributes. |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 1k · 1.5k · 2k · Par défaut: 2k |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.
| Option | Crédits par image | ≈ USD |
|---|---|---|
| Standard | 4,35 | 0,044 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 5 crédits par image (0,05 $US).
Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.
Démarrage rapide de l'API
Appeler l’API Seedream 5.0 Flash en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model bytedance/seedream-5.0-flash/edit et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-flash/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "2k",
"output_format": "jpeg",
"background": "opaque"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API Seedream 5.0 Flash
Combien coûte l’API Seedream 5.0 Flash ?
Seedream 5.0 Flash coûte à partir de 5 crédits (0,05 $US) par image avec Modifier une image, sa tâche la moins chère. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.
Quel est le nom de modèle de Seedream 5.0 Flash dans l’API ?
Indiquez bytedance/seedream-5.0-flash/text-to-image pour Créer une image; bytedance/seedream-5.0-flash/edit pour Modifier une image; bytedance/seedream-5.0-flash/layer-decomposition pour Séparateur de calques dans le champ model de POST /jobs/createTask.
Qu’est-ce que la séparation en calques ?
Vous envoyez une image terminée et vous récupérez une image de fond, où les éléments séparés sont retirés et l’arrière-plan reconstitué, plus jusqu’à seize PNG transparents, un par élément : une personne, un titre, un produit ou un accessoire. Vous pouvez ensuite déplacer, redimensionner, remplacer, recolorer ou écarter n’importe quel élément.
Puis-je utiliser plusieurs images de référence ?
Oui, jusqu’à dix sur le point de terminaison de retouche. L’ordre compte, car le prompt les désigne comme première, deuxième et troisième. Donnez un rôle à chacune, par exemple visage de l’image 1, robe de l’image 2, lieu de l’image 3.
Existe-t-il un seed pour obtenir des résultats reproductibles ?
Non. Flash n’expose aucun seed sur aucun point de terminaison : deux requêtes identiques rendent des résultats différents. Conservez ensemble le prompt et l’asset renvoyé.
Quelles sont les limites de l’API Seedream 5.0 Flash ?
Résolutions: 1K · 1.5K · 2K; Formats d’image: auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 +10; Images de référence: 10; Longueur du prompt (caractères): 5,000; Taille maximale d’envoi: 30 MB. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Seedream 5.0 Flash sans écrire de code ?
Oui. Le Playground lance Seedream 5.0 Flash avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
Tous les modèles Seedream
Seedream 5.0 Pro investit davantage dans le détail des matières pour les images finales et coûte plus cher en 2K. Flash est la façon la plus rapide et la moins chère de passer en revue des idées.
- API Seedream 5.0 ProImages et retouches très détaillées à partir de dix référencesÀ partir de 6 crédits par image
- API Seedream 5.0 FlashSeedream rapide : images, retouches et calques jusqu’en 2KÀ partir de 4 crédits par image
- API Seedream 5.0 LiteDes images 2K à taille fixe pour garder une série cohérenteÀ partir de 6 crédits par image
- API Seedream 4.0Tailles exactes jusqu’à 4096×2304 et retouches à dix référencesÀ partir de 5 crédits par image

