Instrucciones

Recetas de IA probadas para crear imágenes o SVG. Usa su prompt en un trabajo generate_image (tipo image) o generate_svg (tipo svg).

Endpoint	Descripción
GET `/prompts`	Listar instrucciones
GET `/prompts/{slug}`	Obtener una instrucción

Listar instrucciones

GET/prompts

Devuelve las instrucciones publicadas, por orden alfabético.

Parámetros de consulta

Nombre	Tipo	Descripción
`q`	texto	Busca en el título y el resumen.
`type`	texto	`image` o `svg`.
`page`	entero	Página, desde 1.
`page_size`	entero	Resultados por página (24 por defecto, máximo 100).

Ejemplo

curl "https://creavibe.app/api/v1/prompts?type=image&page_size=2" \
  -H "Authorization: Bearer cv_TU_TOKEN"

const respuesta = await fetch('https://creavibe.app/api/v1/prompts?type=image&page_size=2', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer cv_TU_TOKEN',
  },
});
const datos = await respuesta.json();

import requests

respuesta = requests.get(
    "https://creavibe.app/api/v1/prompts?type=image&page_size=2",
    headers={"Authorization": "Bearer cv_TU_TOKEN"},
)
datos = respuesta.json()

Respuesta · 200

{
  "count": 20,
  "next": "https://creavibe.app/api/v1/prompts?page_size=2&type=image&page=2",
  "previous": null,
  "results": [
    {
      "slug": "cara-de-reaccion",
      "title": "Cara de reacción",
      "type": "image",
      "summary": "Un personaje con una expresión exagerada, lista para añadirle tu texto.",
      "category": "Memes",
      "image_url": "https://creavibe.app/media/fichas/cara-de-reaccion.webp"
    },
    {
      "slug": "degradado-suave",
      "title": "Degradado suave",
      "type": "image",
      "summary": "Fondo con degradado suave entre dos colores de tu marca, sin ruido.",
      "category": "Fondos",
      "image_url": "https://creavibe.app/media/fichas/degradado-suave_QhVY7Ke.webp"
    }
  ]
}

Errores: 401, 422, 429

Obtener una instrucción

GET/prompts/{slug}

Devuelve el texto de la instrucción (prompt) y qué produce (result). requires_photo indica que está pensada para transformar una foto tuya.

Parámetros de la ruta

Nombre	Tipo	Descripción
`slug`obligatorio	texto	Slug de la instrucción.

Ejemplo

curl "https://creavibe.app/api/v1/prompts/cara-de-reaccion" \
  -H "Authorization: Bearer cv_TU_TOKEN"

const respuesta = await fetch('https://creavibe.app/api/v1/prompts/cara-de-reaccion', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer cv_TU_TOKEN',
  },
});
const datos = await respuesta.json();

import requests

respuesta = requests.get(
    "https://creavibe.app/api/v1/prompts/cara-de-reaccion",
    headers={"Authorization": "Bearer cv_TU_TOKEN"},
)
datos = respuesta.json()

Respuesta · 200

{
  "slug": "cara-de-reaccion",
  "title": "Cara de reacción",
  "type": "image",
  "prompt": "Cara de reacción. Estilo limpio y profesional, colores de marca, alta calidad, composición centrada.",
  "result": "Imagen · 2048 × 2048 px",
  "requires_photo": false
}

Errores: 401, 404