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": 5,
      "transition": "slide",
      "design": {
        "snapshot": {
          "quote": "Begin with one clear step.",
          "ratio": "tiktok"
        },
        "imageUrl": "https://images.example.com/background.jpg",
        "bgMode": "image"
      }
    }]
  }'

• 60 slides maximum par collection.
• durationSeconds: 1–30.
• transition: fade, slide, zoom, cut.
• 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

Nouveautés