Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
image_url | Oui | L’image de départ. |
output_format | Non | Le type de fichier du résultat. jpeg · png · Par défaut: jpeg |
prompt | Non | Optional: name the elements to separate. Leave empty to let the model pick the main elements. |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. auto · 1k · 1.5k · 2k · Par défaut: 1.5k |
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 |
|---|---|---|
| resolution 1.5K | 6,3 | 0,063 $US |
| resolution 1K | 6,3 | 0,063 $US |
| resolution 2K | 12,6 | 0,13 $US |
| resolution auto | 12,6 | 0,13 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 7 crédits par image (0,07 $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 Pro 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-pro/layer-decomposition 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-pro/layer-decomposition",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1.5k",
"output_format": "jpeg"
}
}'
# 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 Pro
Combien coûte l’API Seedream 5.0 Pro ?
Seedream 5.0 Pro coûte à partir de 7 crédits (0,07 $US) par image avec Séparateur de calques, sa tâche la moins chère. Prix par option : 1.5K 6,3 crédits par image, 1K 6,3 crédits par image, 2K 12,6 crédits par image, auto 12,6 crédits par image. 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 Pro dans l’API ?
Indiquez bytedance/seedream-5.0-pro/text-to-image pour Créer une image; bytedance/seedream-5.0-pro/edit pour Modifier une image; bytedance/seedream-5.0-pro/layer-decomposition pour Séparateur de calques dans le champ model de POST /jobs/createTask.
Combien d’images de référence une retouche accepte-t-elle ?
Jusqu’à dix. Attribuez un rôle à chacune dans le prompt, car les sources non nommées se font mélanger. Chaque référence au-delà de la première pèse sur le devis affiché avant l’envoi.
Puis-je régler la taille de sortie ou le ratio d’image ?
Oui, sous forme de format et de palier plutôt que de pixels libres. aspect_ratio propose quinze formes de 1:3 à 3:1, et resolution choisit 1k ou 2k. Text-to-image vaut 1:1 par défaut ; l’édition vaut auto, qui retient le format pris en charge le plus proche de votre première référence. S’il vous faut un préréglage largeur*hauteur nommé, utilisez Seedream 5.0 Lite.
Y a-t-il une seed pour des résultats reproductibles ?
Non. Aucun des deux points de terminaison n’en expose : deux requêtes identiques rendent donc deux images différentes. Gardez le prompt stocké avec tout asset que vous comptez réutiliser.
JPEG ou PNG — lequel demander ?
png quand l’image repart en retouche ou en compositing et que des contours sans perte comptent ; jpeg pour les boucles de relecture et la livraison directe. Cela change le fichier que vous recevez, pas l’image qui a été générée.
Sait-il écrire du texte dans l’image ?
De courtes chaînes tombent parfois juste, mais ce n’est pas ce à quoi ce modèle est destiné. Pour les enseignes, les titres et les textes d’emballage, prenez un modèle fait pour la typographie dans l’image.
Quelles sont les limites de l’API Seedream 5.0 Pro ?
Résolutions: auto · 1K · 1.5K · 2K; 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 Pro sans écrire de code ?
Oui. Le Playground lance Seedream 5.0 Pro 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 Lite travaille en tailles 2K fixes, ce qui garde une série cohérente, et Seedream 5.0 Flash est le cousin plus rapide et moins cher. Pro est celui de l'image finale, la plus détaillée.
- 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

