Fonctionnalité · Photos de détails

API de photos de détails produit pour les plans rapprochés

En une phrase

L'API de photos de détails de Photta génère un plan rapproché d'une zone précise d'un produit. Un appel analyze gratuit suggère les détails pertinents ; l'appel generate coûte 3 crédits fixes, sans paliers de résolution.

Obtenir une clé APIConsulter la documentation
  • Délai typique: 20–60 sec
  • Crédits: 3 crédits
  • Traitement: asynchrone, polling
  • Limites: 600 requêtes/min
  • Authentification: Clé Bearer

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié

POST/api/v1/detail-photos
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/detail-photos \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
  "detail_label": "collar stitching",
  "detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
  "framing": "extreme-closeup",
  "source_type": "apparel"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

En un coup d'œil

En un coup d'œil

Endpoint
POST /api/v1/detail-photos
Authentification
Clé API Bearer
Traitement
Asynchrone — interrogez l'endpoint de statut par polling
Délai typique
20–60 sec
Crédits
3 crédits
Limites d'entrée
Jusqu'à 10 Mo par image ; JPEG, PNG, WebP
Idempotent
Non

Requête et réponse

Requête

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/detail-photos \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
  "detail_label": "collar stitching",
  "detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
  "framing": "extreme-closeup",
  "source_type": "apparel"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

202 Accepted / Terminé

{
  "data": {
    "id": "dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10",
    "status": "processing",
    "detail_label": "collar stitching",
    "framing": "extreme-closeup",
    "credits_used": 3,
    "created_at": "2026-07-30T14:20:00Z"
  },
  "request_id": "req_dtl001"
}

Paramètres de requête

product_image

Type: stringRequis

The source image — a completed generation's output_url or any product photo. https URL or base64 data URI. JPEG, PNG, WebP; max 10 MB.

detail_label

Type: stringRequis

The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.

detail_description

Type: string

Extra guidance for the close-up. Max 400 characters.

framing

Type: string

How tight the crop is: "extreme-closeup" — the detail fills ~90% of the frame (near-macro); "closeup" — ~70% with some surrounding context; "medium-closeup" — ~50% with body/outfit visible.

= medium-closeup

Valeurs: extreme-closeupcloseupmedium-closeup
source_type

Type: string

Tunes what is preserved in the close-up.

= apparel

Valeurs: appareljewelry

Erreurs

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

Limites

  • 600 requêtes par minute par clé API (Fenêtre fixe ; la limite est identique sur tous les forfaits)
  • Une 429 renvoie Retry-After: 30 secondes
  • Jusqu'à 10 Mo par image
  • Formats: JPEG, PNG, WebP
  • Lots simultanés par forfait: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Polling uniquement — l'API n'envoie aucun webhook.

Identifiez les détails pertinents, puis générez-les

Analysez gratuitement, sélectionnez un détail, envoyez la requête, effectuez le polling, téléchargez.

  1. Étape 1

    Générer une clé API

    Les photos de détails utilisent les mêmes identifiants et le même solde de crédits que toutes les autres fonctionnalités de Photta.

  2. Étape 2

    Identifier les détails à photographier

    Envoyez un POST sur `/api/v1/detail-photos/analyze` avec `product_image`. L'endpoint renvoie de manière synchrone des valeurs suggérées pour `detail_label`, `detail_description` et `framing` pour ce produit, sans aucun débit.

  3. Étape 3

    Envoyer la requête de plan rapproché

    Envoyez un POST sur `/api/v1/detail-photos` avec `product_image` et `detail_label`. Définissez `framing` sur `extreme-closeup`, `closeup` ou `medium-closeup`, `source_type` sur `apparel` ou `jewelry`, et ajoutez jusqu'à 400 caractères de `detail_description`.

  4. Étape 4

    Effectuer le polling jusqu'à la fin du traitement

    Effectuez un GET sur `/api/v1/detail-photos/:id` toutes les 3 secondes jusqu'à ce que `data.status` passe à `completed` ou `failed` ; le traitement prend généralement 20 à 60 secondes.

  5. Étape 5

    Télécharger et persister

    Le corps de la réponse terminée contient `output_url`. Les photos de détails s'intègrent directement dans la galerie d'une fiche produit aux côtés du visuel principal.

Le même endpoint en Node.js, Python et cURL

Questions fréquentes des développeurs avant d'intégrer les photos de détails

Qu'est-ce qu'une API de photos de détails ?

Un endpoint qui génère un plan rapproché d'une zone ciblée d'un produit — les coutures d'un col, un fermoir, le tissage sur la poitrine — à partir d'une simple photo plus large, sans nécessiter de second shooting en studio avec un objectif macro.

Combien coûte une photo de détail ?

3 crédits fixes. Cet endpoint ne comporte aucun palier de résolution, et l'appel analyze suggérant les détails est gratuit.

Que renvoie l'endpoint analyze ?

Une liste de suggestions, chacune contenant un `detail_label`, une `detail_description` expliquant la pertinence de cette zone, et un `framing` recommandé. Transmettez directement n'importe quelle suggestion à l'appel generate.

À quel point chaque option de cadrage est-elle serrée ?

`extreme-closeup` remplit presque tout le cadre avec le détail, `closeup` conserve un léger contexte autour, et `medium-closeup` montre le détail au sein du vêtement ou de la pièce. Choisissez le cadrage par détail, et non par produit.

L'image source peut-elle être une image générée ?

Oui. `product_image` accepte l' `output_url` d'une génération terminée ainsi que n'importe quelle photo de produit personnelle, sous forme d'URL https ou d'URI de données base64.

Comment effectuer le polling pour obtenir le résultat ?

GET `/api/v1/detail-photos/:id` toutes les 3 secondes jusqu'à ce que `data.status` soit `completed` ou `failed`. L'appel d'analyse est synchrone et ne nécessite aucun polling.

Fonctionnalités associées

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié

Testez l'API en cinq minutes

Générez une clé d'API Photta, collez le snippet cURL ci-dessus, et vous obtiendrez votre première photo portée sur modèle avant même que le café ait fini de couler.

Créer un compte et obtenir une clé APIConsulter la documentation
  • 20–60 sec
  • 3 crédits
  • asynchrone, polling
  • 600 requêtes/min
  • Clé Bearer