RÉFÉRENCE API

Référence API PromptLabHub

Accédez à vos prompts enregistrés, exécutez des requêtes de recherche, filtrez par modèles et interrogez les catégories de prompts par programmation avec une faible latence.

Obtenir une clé API Journal des modifications API

Authentification

Toutes les requêtes API doivent être authentifiées à l'aide d'un jeton Bearer dans l'en-tête Authorization. Les clés API peuvent être gérées depuis vos Paramètres API.

En-tête Authorization

Authorization: Bearer plh_live_your_key_here

Limites de débit et quotas

Les limites de débit sont appliquées par clé API sur une base quotidienne et mensuelle selon le niveau de votre formule. Les requêtes actives renvoient les en-têtes standard de limitation de débit.

Niveau d'abonnement

Niveau d'abonnement	Limite quotidienne	Limite mensuelle
Gratuit	100	3,000
Pro	1,000	30,000
Enterprise	10,000	300,000

En-têtes de réponse de limitation de débit

En-tête	Description
X-RateLimit-Limit	Le nombre maximum de requêtes autorisées par jour.
X-RateLimit-Remaining	Le nombre de requêtes restantes pour la journée en cours.
X-RateLimit-Reset	L'heure UTC à laquelle la fenêtre de limitation de débit actuelle se réinitialise (en secondes).

Points de terminaison API

GET/api/v1/prompts

Récupérez une liste paginée de prompts publiés, avec prise en charge des mots-clés de recherche et du filtrage par catégorie.

Query Parameters

Champ	Type	Obligatoire	Description
category	string	Non	Filtrer par slug ou nom de catégorie
search	string	Non	Mots-clés correspondant au titre, à la description ou au contenu
page	number	Non (1)	Index de page pour la pagination
limit	number	Non (20)	Taille maximale retournée (1 - 50)

curl -X GET "https://promptlabhub.com/api/v1/prompts?category=photography&search=sunset" \
  -H "Authorization: Bearer plh_live_your_key_here"

JSON

{
  "data": [
    {
      "id": "triple-ice-cream-fantasy",
      "title": "Triple Ice Cream Fantasy",
      "category": "food-photography",
      "model": "Midjourney",
      "copyCount": 1420,
      "createdAt": "2025-05-10T00: 00: 00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 384
  }
}

GET/api/v1/prompts/:slug

Récupérez les détails d'un prompt spécifique par son identifiant.

Paramètres de requête

Champ	Type	Obligatoire	Description
slug	string	Oui	Le slug unique identifiant le prompt

cURL

curl -X GET "https://promptlabhub.com/api/v1/prompts/triple-ice-cream-fantasy" \
  -H "Authorization: Bearer plh_live_your_key_here"

JSON

{
  "id": "triple-ice-cream-fantasy",
  "title": "Triple Ice Cream Fantasy",
  "content": "\"resolution\": \"8K\", \"aspect_ratio\": \"3: 4\"...",
  "category": "food-photography",
  "model": "Midjourney",
  "difficulty": "Advanced",
  "copyCount": 1420,
  "createdAt": "2025-05-10T00: 00: 00Z"
}

POST/api/v1/prompts

Soumettez un prompt pour approbation/modération dynamiquement.

Paramètres du corps de requête

Champ	Type	Obligatoire	Description
title	string	Oui	Le titre de création du prompt
description	string	Oui	Résumé court / notes pour les options
content	string	Oui	La formulation complète du texte du prompt IA
category	string/number	Oui	Identifiant, nom ou slug de catégorie

cURL

curl -X POST "https://promptlabhub.com/api/v1/prompts" \
  -H "Authorization: Bearer plh_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Neon Tokyo Street Night",
    "description": "Cinematic cyberpunk street scene",
    "content": "neon-lit alley, rain reflections, 8K...",
    "category": "photography"
  }'

JSON

{
  "data": {
    "id": "neon-tokyo-street-night",
    "status": "pending"
  }
}

GET/api/v1/categories

Listez toutes les catégories de prompts disponibles.

cURL

curl -X GET "https://promptlabhub.com/api/v1/categories" \
  -H "Authorization: Bearer plh_live_your_key_here"

JSON

{
  "data": [
    { "slug": "photography", "name": "Photo Prompts" },
    { "slug": "food-photography", "name": "Food Prompts" },
    { "slug": "video", "name": "Video Prompts" }
  ]
}

Codes d'erreur HTTP

Statut HTTP	Chaîne de code	Description
400	VALIDATION_FAILED	Les paramètres du corps de requête sont invalides ou manquants.
401	UNAUTHORIZED	L'en-tête de clé API est absent, incorrect ou le jeton a été révoqué.
404	NOT_FOUND	L'identifiant de prompt ou la ressource demandée n'a pas été trouvé.
429	RATE_LIMIT_EXCEEDED	Votre quota quotidien de clé API a été atteint. Passez à Pro/Enterprise pour des limites plus élevées.
500	INTERNAL_SERVER_ERROR	Une erreur serveur inattendue s'est produite. Réessayez ultérieurement.

Exemples d'intégration

JavaScript Fetch

"text-[#6b7280]">// JavaScript fetch example
"text-[#f97583]">const apiKey = 'plh_live_your_key_here'

"text-[#f97583]">async "text-[#f97583]">function fetchPrompts() {
  "text-[#f97583]">const response = "text-[#f97583]">await fetch('https:"text-[#6b7280]">//promptlabhub.com/api/v1/prompts?limit=5', {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  })
  "text-[#f97583]">const data = "text-[#f97583]">await response.json()
  "text-[#f97583]">console.log(data.data)
}

fetchPrompts()

Python Requests

"text-[#f97583]">class="text-[#6b7280]"># Python requests example
"text-[#f97583]">import requests

api_key = 'plh_live_your_key_here'
url = 'https://promptlabhub.com/api/v1/prompts'
headers = {'Authorization': f'Bearer {api_key}'}
params = {'limit': 5}

response = requests.get(url, headers=headers, params=params)
"text-[#f97583]">print(response.json())

SDK officiels

Les SDK pour Node.js, Python et Go arrivent bientôt. Pour l'instant, vous pouvez vous connecter directement en utilisant des bibliothèques HTTP standard ou des exemples curl.

Node.js — Coming SoonPython — Coming SoonGo — Coming Soon

Niveau d'abonnement

Limite quotidienne

Limite mensuelle

Gratuit

100

3,000

Pro

1,000

30,000

Enterprise

10,000

300,000

En-tête

Description

X-RateLimit-Limit

Le nombre maximum de requêtes autorisées par jour.

X-RateLimit-Remaining

Le nombre de requêtes restantes pour la journée en cours.

X-RateLimit-Reset

L'heure UTC à laquelle la fenêtre de limitation de débit actuelle se réinitialise (en secondes).

Champ

Type

Obligatoire

Description