Documentation API

Démarrage

Authentification

Tous les endpoints publics documentés ici acceptent la même clé. Les ressources sont toujours limitées au propriétaire authentifié.

Authorization: Bearer qqm_live_REPLACE_WITH_YOUR_KEY
Content-Type: application/json

Génération

Limite spécifique : 20 requêtes par minute.

Mode rapide

Le mode quick couvre les paramètres courants sans envoyer un snapshot complet du Studio.

curl --request POST "https://www.quickquotemaker.com/api/studio/generate" \
  --header "Authorization: Bearer qqm_live_REPLACE_WITH_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "mode": "quick",
    "name": "Daily inspiration",
    "quick": {
      "text": "The future depends on what you do today.",
      "author": "Mahatma Gandhi",
      "ratio": "instagramPost",
      "fontFamily": "Playfair Display",
      "textColor": "#ffffff",
      "align": "center",
      "quoteMark": "curly",
      "bold": true,
      "background": {
        "type": "gradient",
        "from": "#0f172a",
        "to": "#2563eb"
      }
    }
  }'

Mode snapshot

Le mode snapshot accepte le design complet du Quote Studio : typographie distincte des trois textes, arrière-plan, filtres, overlay, bordure, ombres, boîtes de texte, transformations, positions et watermarks.

{
  "mode": "snapshot",
  "name": "Story campaign",
  "design": {
    "quote": "Build something worth sharing.",
    "author": "QuickQuoteMaker",
    "freeText": "@yourbrand",
    "ratio": "tiktok",
    "bgMode": "image",
    "overlayOn": true,
    "overlayColor": "#020617",
    "overlayOpacity": 45,
    "fontFamily": "Comfortaa",
    "fontSize": 68,
    "textColor": "#ffffff",
    "align": "center",
    "bold": true,
    "watermarkTextOn": true,
    "watermarkText": "quickquotemaker.com"
  },
  "backgroundUrl": "https://images.example.com/background.jpg",
  "record": true
}

backgroundUrl remplace l’image définie dans design. Les champs omis utilisent les valeurs par défaut normalisées du Studio.

Arrière-plan vidéo

Une URL vidéo HTTPS publique produit un MP4 silencieux avec le texte, les filtres, l’overlay, les watermarks et la bordure du Studio.

{
  "mode": "snapshot",
  "design": {
    "quote": "Motion makes the message visible.",
    "author": "QuickQuoteMaker",
    "ratio": "instagramStory",
    "bgMode": "video"
  },
  "videoUrl": "https://cdn.example.com/background.mp4",
  "durationSeconds": 8,
  "record": true
}

• Vidéo source : 50 Mo maximum.
• Durée : de 2 à 15 secondes, 6 secondes par défaut.
• videoUrl remplace les autres arrière-plans.
• La sortie ne contient aucune piste audio.

Collections

curl --request POST "https://www.quickquotemaker.com/api/collections" \
  --header "Authorization: Bearer qqm_live_REPLACE_WITH_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "title": "Daily inspiration",
    "slides": [{
      "id": "slide-1",
      "durationSeconds": 2.5,
      "transition": "slide",
      "design": {
        "snapshot": {
          "quote": "Begin with one clear step.",
          "ratio": "tiktok"
        },
        "videoUrl": "https://cdn.example.com/background.mp4",
        "posterUrl": "https://cdn.example.com/poster.jpg",
        "startSeconds": 1.5,
        "marker": false,
        "bgMode": "video"
      }
    }]
  }'

• 60 slides maximum par collection.
• durationSeconds: 1–30. Les valeurs fractionnaires sont acceptées, par exemple 2.5.
• transition: fade, slide, zoom, cut.
• design.bgMode: gradient, solid, image, video.
• Fond vidéo : renseignez design.videoUrl et design.posterUrl.
• design.startSeconds: 0–3600. Décale le début du clip pour éviter une ouverture faible. Ignoré hors fond vidéo.
• design.marker: booléen. Marque une carte d’interruption (TOP 10, TOP 5) : son titre entre avec un zoom plus marqué que les autres slides.
• Les titres sont uniques par utilisateur, sans distinction de casse ou d’espaces superflus.
• Un titre dupliqué retourne HTTP 409 avec collection_title_duplicate.

Référence

Formats disponibles

Réponse de génération

{
  "id": "f3f0ea51-086d-4bc2-8f63-5c63e73db902",
  "url": "https://PROJECT.supabase.co/storage/v1/object/public/downloaded-images/ID.png",
  "width": 1080,
  "height": 1080,
  "format": "PNG"
}

Limitation globale

Les réponses limitées utilisent HTTP 429 et fournissent Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.

Erreurs

En production, les réponses d’erreur ne contiennent que le champ error. Les détails internes (message, code et hint de la base de données) sont retirés et restent uniquement dans les journaux serveur.

Nouveautés