REFERENCIA API

Referencia API de PromptLabHub

Accede a tus prompts guardados, ejecuta consultas de búsqueda, filtra por modelos y consulta categorías de prompts de forma programática con baja latencia.

Obtener una Clave API Changelog de API

Autenticación

Todas las solicitudes API deben autenticarse usando un token Bearer en el encabezado Authorization. Las claves API se gestionan desde tu Configuración de API.

Encabezado Authorization

Authorization: Bearer plh_live_your_key_here

Límites de Tasa y Cuotas

Los límites de tasa se aplican por clave API de forma diaria y mensual según el nivel de tu plan. Las solicitudes activas devuelven encabezados estándar de rate limiting.

Nivel de Suscripción

Nivel de Suscripción	Límite Diario	Límite Mensual
Free	100	3,000
Pro	1,000	30,000
Enterprise	10,000	300,000

Encabezados de Respuesta de Límite de Tasa

Encabezado	Descripción
X-RateLimit-Limit	El número máximo de solicitudes permitidas por día.
X-RateLimit-Remaining	El número de solicitudes restantes para el día actual.
X-RateLimit-Reset	La hora UTC cuando se reinicia la ventana actual de límite de tasa (en segundos).

Endpoints de API

GET/api/v1/prompts

Recupera una lista paginada de prompts publicados, con soporte para palabras clave de búsqueda y filtrado por categoría.

Query Parameters

Campo	Tipo	Requerido	Descripción
category	string	No	Filtrar por slug o nombre de categoría
search	string	No	Palabras clave que coincidan con título, descripción o contenido
page	number	No (1)	Índice de página para paginación
limit	number	No (20)	Tamaño máximo devuelto (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

Recupera los detalles de un prompt específico por su ID.

Parámetros de Consulta

Campo	Tipo	Requerido	Descripción
slug	string	Sí	El slug único que identifica el 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

Envía un prompt para aprobación/moderación de forma dinámica.

Parámetros del Cuerpo de Solicitud

Campo	Tipo	Requerido	Descripción
title	string	Sí	El título de creación del prompt
description	string	Sí	Resumen breve / notas para opciones
content	string	Sí	La formulación completa del texto del prompt de IA
category	string/number	Sí	ID, nombre o slug de categoría

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

Lista todas las categorías 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" }
  ]
}

Códigos de Error HTTP

Estado HTTP	Código String	Descripción
400	VALIDATION_FAILED	Los parámetros del cuerpo de solicitud son inválidos o faltan.
401	UNAUTHORIZED	El encabezado de clave API falta, es incorrecto o el token fue revocado.
404	NOT_FOUND	El ID de prompt o recurso solicitado no fue encontrado.
429	RATE_LIMIT_EXCEEDED	Se alcanzó la cuota diaria de tu clave API. Actualiza a Pro/Enterprise para límites más altos.
500	INTERNAL_SERVER_ERROR	Ocurrió un error inesperado del servidor. Intenta de nuevo más tarde.

Ejemplos de Integración

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())

SDKs Oficiales

Los SDKs para Node.js, Python y Go llegarán pronto. Por ahora, puedes conectarte directamente usando bibliotecas HTTP estándar o ejemplos de curl.

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

Nivel de Suscripción

Límite Diario

Límite Mensual

Free

100

3,000

Pro

1,000

30,000

Enterprise

10,000

300,000

Encabezado

Descripción

X-RateLimit-Limit

El número máximo de solicitudes permitidas por día.

X-RateLimit-Remaining

El número de solicitudes restantes para el día actual.

X-RateLimit-Reset

La hora UTC cuando se reinicia la ventana actual de límite de tasa (en segundos).

Campo

Tipo

Requerido

Descripción