Banco de imágenes

Imágenes públicas de CreaVibe y las tuyas, listas para añadir a tu biblioteca.

Endpoint	Descripción
GET `/stock-images`	Buscar imágenes
GET `/stock-images/{id}`	Obtener una imagen
POST `/assets/imports`	Añadir a la biblioteca

Buscar imágenes

GET/stock-images

Devuelve imágenes del banco, de la más reciente a la más antigua.

Parámetros de consulta

Nombre	Tipo	Descripción
`q`	texto	Busca en el nombre, la descripción y el prompt.
`type`	texto	`image` o `svg`.
`format`	texto	`square`, `portrait` o `landscape`.
`category`	texto	Slug de una categoría.
`style`	texto	Slug de un estilo.
`mine`	booleano	`true`: solo las tuyas.
`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/stock-images?type=image&page_size=2" \
  -H "Authorization: Bearer cv_TU_TOKEN"

const respuesta = await fetch('https://creavibe.app/api/v1/stock-images?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/stock-images?type=image&page_size=2",
    headers={"Authorization": "Bearer cv_TU_TOKEN"},
)
datos = respuesta.json()

Respuesta · 200

{
  "count": 6,
  "next": "https://creavibe.app/api/v1/stock-images?page_size=2&type=image&page=2",
  "previous": null,
  "results": [
    {
      "id": "255a03fa-f844-4c49-a445-54ff134bf106",
      "name": "Cachorro Shiba Inu estilo sticker",
      "description": "Ilustración de un adorable cachorro Shiba Inu marrón con mejillas rosadas y su cola separada, en un estilo de sticker limpio y profesional.",
      "url": "https://creavibe.app/media/banco/2026/10/b97bdc70aa184ae1ac39e057bb2d2e48.png",
      "thumbnail_url": "https://creavibe.app/media/banco/miniaturas/2026/10/b97bdc70aa184ae1ac39e057bb2d2e48.jpg",
      "type": "image",
      "width": 1024,
      "height": 1024,
      "format": "square",
      "source": "generated",
      "style": null,
      "category": {
        "slug": "ilustracion",
        "name": "Ilustración"
      },
      "author": "plomobit",
      "public": true,
      "is_mine": false,
      "created_at": "2026-10-10T17:32:28.898Z"
    },
    {
      "id": "2e56df12-b303-45ed-8221-0e6db8ec2a6e",
      "name": "Avión Vueling A230 ilustración vectorial",
      "description": "Ilustración vectorial de un avión Vueling A230 blanco y amarillo, con puntos negros en la cola y el fuselaje, sobre fondo blanco.",
      "url": "https://creavibe.app/media/banco/2026/10/51173da868b64f71b1553e3ab2a4ada6.png",
      "thumbnail_url": "https://creavibe.app/media/banco/miniaturas/2026/10/51173da868b64f71b1553e3ab2a4ada6.jpg",
      "type": "image",
      "width": 1024,
      "height": 1024,
      "format": "square",
      "source": "generated",
      "style": null,
      "category": {
        "slug": "objetos",
        "name": "Objetos"
      },
      "author": "plomobit",
      "public": true,
      "is_mine": false,
      "created_at": "2026-10-09T18:56:16.209Z"
    }
  ]
}

Errores: 401, 422, 429

Obtener una imagen

GET/stock-images/{id}

Devuelve una imagen del banco.

Parámetros de la ruta

Nombre	Tipo	Descripción
`id`obligatorio	uuid	Id de la imagen.

Ejemplo

curl "https://creavibe.app/api/v1/stock-images/255a03fa-f844-4c49-a445-54ff134bf106" \
  -H "Authorization: Bearer cv_TU_TOKEN"

const respuesta = await fetch('https://creavibe.app/api/v1/stock-images/255a03fa-f844-4c49-a445-54ff134bf106', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer cv_TU_TOKEN',
  },
});
const datos = await respuesta.json();

import requests

respuesta = requests.get(
    "https://creavibe.app/api/v1/stock-images/255a03fa-f844-4c49-a445-54ff134bf106",
    headers={"Authorization": "Bearer cv_TU_TOKEN"},
)
datos = respuesta.json()

Respuesta · 200

{
  "id": "255a03fa-f844-4c49-a445-54ff134bf106",
  "name": "Cachorro Shiba Inu estilo sticker",
  "description": "Ilustración de un adorable cachorro Shiba Inu marrón con mejillas rosadas y su cola separada, en un estilo de sticker limpio y profesional.",
  "url": "https://creavibe.app/media/banco/2026/10/b97bdc70aa184ae1ac39e057bb2d2e48.png",
  "thumbnail_url": "https://creavibe.app/media/banco/miniaturas/2026/10/b97bdc70aa184ae1ac39e057bb2d2e48.jpg",
  "type": "image",
  "width": 1024,
  "height": 1024,
  "format": "square",
  "source": "generated",
  "style": null,
  "category": {
    "slug": "ilustracion",
    "name": "Ilustración"
  },
  "author": "plomobit",
  "public": true,
  "is_mine": false,
  "created_at": "2026-10-10T17:32:28.898Z"
}

Errores: 401, 404

Añadir a la biblioteca

POST/assets/imports

Copia una imagen del banco a tu biblioteca para usarla en tus diseños. Si ya estaba, devuelve la misma con 200.

Cuerpo (JSON)

Nombre	Tipo	Descripción
`stock_image_id`obligatorio	uuid	Id de la imagen del banco.

Ejemplo

curl -X POST "https://creavibe.app/api/v1/assets/imports" \
  -H "Authorization: Bearer cv_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"stock_image_id":"255a03fa-f844-4c49-a445-54ff134bf106"}'

const respuesta = await fetch('https://creavibe.app/api/v1/assets/imports', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer cv_TU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "stock_image_id": "255a03fa-f844-4c49-a445-54ff134bf106"
  }),
});
const datos = await respuesta.json();

import requests

respuesta = requests.post(
    "https://creavibe.app/api/v1/assets/imports",
    headers={"Authorization": "Bearer cv_TU_TOKEN"},
    json={
        "stock_image_id": "255a03fa-f844-4c49-a445-54ff134bf106"
    },
)
datos = respuesta.json()

Cabeceras de la respuesta

Location: /api/v1/assets/cb901a12-c1cb-4537-9d7f-ac405cee99fc

Respuesta · 201

{
  "id": "cb901a12-c1cb-4537-9d7f-ac405cee99fc",
  "url": "https://creavibe.app/media/recursos/017dfef2-eaf5-429a-86f3-307b8bf36189/a87043f5af914dff94bae99459fd34d7.png",
  "thumbnail_url": "https://creavibe.app/media/miniaturas/recurso/ec423cada40a4bd294e91492b4ac7210.webp",
  "type": "image",
  "source": "stock",
  "name": "Cachorro Shiba Inu estilo sticker",
  "font_family": null,
  "width": 1024,
  "height": 1024,
  "size_bytes": 547203,
  "created_at": "2026-10-12T10:10:32.054Z"
}

Errores: 401, 404, 422, 429