À propos de Relight
Décrivez le nouvel éclairage et obtenez la même photo rééclairée.
Appelez-le avec le nom de modèle popnow/relight-v1/edit sur POST /jobs/createTask, à partir de 30 crédits par image (0,03 $US).
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. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Oui | L’image de départ. |
output_format | Non | Le type de fichier du résultat. jpeg · png · webp · Par défaut: jpeg |
prompt | Oui | The new light: source, direction, colour and hardness, e.g. "Relight the image with warm golden sunset light from a window on the left." |
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,001 $). 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 | 30 | 0,03 $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 Relight 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 popnow/relight-v1/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": "popnow/relight-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 Relight
Combien coûte l’API Relight ?
Relight coûte 30 crédits (0,03 $US) par image. Les crédits sont les mêmes que sur le site (1 crédit = 0,001 $) et les tâches échouées sont remboursées.
Quel est le nom de modèle de Relight dans l’API ?
Indiquez popnow/relight-v1/edit pour Rééclairer dans le champ model de POST /jobs/createTask.
Comment décrire la lumière ?
Nommez la source, la direction, la couleur et la dureté : « warm golden sunset light coming through a window on the left, hard light with window-frame shadows » ou « a single hard spotlight from directly above in a dark studio ».
La personne ou la pose vont-elles changer ?
Non. Dans nos essais, les visages, les tenues, les poses et le cadrage sont restés ; seuls la lumière, l’étalonnage des couleurs et les ombres ont changé.
Peut-on passer du jour à la nuit ?
Oui, dans une certaine mesure. Une photo d’étendue de sel prise en plein midi est devenue une heure bleue avec les phares du camion allumés, et une rive brumeuse à l’aube est devenue un coucher de soleil doré.
Qu’apporte le LoRA Relight ?
Avec la même photo, le même prompt et la même seed, le LoRA a donné une lumière plus dure et plus directionnelle, ainsi que des motifs de carreaux de fenêtre sur le mur, là où le modèle de base produisait un changement plus doux.
Quelles sont les limites de l’API Relight ?
Formats d’image: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longueur du prompt (caractères): 1,000; Taille maximale d’envoi: 10 MB. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Relight sans écrire de code ?
Oui. Le Playground lance Relight avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.