Desarrolladores
API de Creativox
Crea productos, genera imágenes y recibe webhooks firmados desde tu código, o conecta Claude Code, Codex y Cursor por MCP. Todo se descuenta de los créditos de tu workspace.
Crear una clave APIPrimeros pasos
Tres pasos desde cero hasta tu primera imagen generada.
1. Crea una clave API
Inicia sesión, abre Ajustes, pestaña API, y crea una clave (solo propietarios y admins del workspace). Cópiala cuando se muestre: no volverás a verla. Guárdala en una variable de entorno, nunca en el control de versiones.
export CREATIVOX_API_KEY="cvx_live_..."2. Comprueba que la clave funciona
Lista los modelos disponibles para tu workspace.
curl -H "Authorization: Bearer $CREATIVOX_API_KEY" https://api.creativox.app/api/v1/models3. Genera tu primera imagen
Envía una generación con una Idempotency-Key para que un reintento nunca te cobre dos veces, y léela hasta que su estado sea completed. Los resultados traen URLs firmadas que caducan; vuelve a pedirlas para obtener nuevas.
curl -X POST https://api.creativox.app/api/v1/generations \
-H "Authorization: Bearer $CREATIVOX_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"type": "txt2img", "format": "1:1", "prompt": "A ceramic mug on a travertine table, soft morning light"}'curl -H "Authorization: Bearer $CREATIVOX_API_KEY" https://api.creativox.app/api/v1/generations/<generation_id>Autenticación y scopes
Envía la clave como bearer token: Authorization: Bearer cvx_live_... (también se acepta la cabecera X-Api-Key). Cada clave pertenece a un workspace y solo puede hacer lo que sus scopes permiten. Nunca puede gestionar facturación, claves API ni miembros.
Authorization: Bearer cvx_live_...| Scope | Permite |
|---|---|
| generations:read | Leer generaciones y sus resultados. |
| generations:write | Crear generaciones y marcar favoritas. |
| products:read | Listar y leer productos. |
| products:write | Crear, editar y borrar productos; subir imágenes, también desde una URL. |
| library:read | Leer la biblioteca de assets. |
| account:read | Leer la cuenta, el saldo de créditos, los modelos y las plantillas. |
Crea claves de solo lectura para paneles y un tope diario de créditos para cada clave que pueda generar.
Errores
Los errores usan estados HTTP estándar y un cuerpo JSON estable. Decide según detail.code, nunca según el texto del mensaje.
{ "detail": { "code": "INSUFFICIENT_CREDITS", "message": "Not enough credits" } }| Estado | Significado |
|---|---|
| 400 | La petición está mal formada. |
| 401 | Clave ausente, revocada o caducada (API_KEY_INVALID). |
| 402 | No hay créditos suficientes (INSUFFICIENT_CREDITS). |
| 403 | La clave no tiene el scope, o el endpoint no está disponible para claves (KEY_NOT_ALLOWED). |
| 404 | El recurso no existe en tu workspace. |
| 409 | Conflicto, por ejemplo PLAN_LIMIT_REACHED cuando tu plan no admite otra clave o webhook. |
| 422 | La validación falló. El detalle indica qué campo. |
| 429 | Límite de peticiones. Espera la cabecera Retry-After (segundos) antes de reintentar. |
Límites por plan
Tu plan fija cuántas claves y endpoints de webhook puedes tener y el tope diario de créditos por defecto de una clave nueva. Las claves existentes siguen funcionando si más adelante se baja un límite.
| Plan | Claves API | Tope diario de créditos por defecto | Endpoints de webhook |
|---|---|---|---|
| Free | 1 | 20 | 0 |
| Starter | 5 | 200 | 2 |
| Pro | 20 | Sin tope | 5 |
Los valores vienen directamente de la API.
Webhooks
En vez de consultar cada poco, registra un endpoint HTTPS en Ajustes, pestaña API. Creativox envía un POST firmado cuando una generación termina o falla. Los webhooks siguen la especificación Standard Webhooks.
Eventos: generation.completed y generation.failed. El payload no incluye URLs de imágenes (caducan): llama a GET /api/v1/generations/{id} para obtenerlas.
{
"type": "generation.completed",
"id": "5d6f6b1e-0c5a-4a43-9d3e-2f2b7a1c9e10",
"created_at": "2026-11-10T12:00:00Z",
"data": {
"generation_id": "c1a2b3d4-0000-4000-8000-000000000000",
"status": "completed",
"model": "<model-id>",
"outputs": [{ "id": "<output-id>" }],
"api_key_id": "<key-id-or-null>"
}
}Cada petición lleva las cabeceras webhook-id, webhook-timestamp y webhook-signature (la cadena v1, seguida del HMAC-SHA256 en base64). El contenido firmado es {webhook-id}.{webhook-timestamp}.{cuerpo crudo} y la clave es la parte base64 de tu secreto whsec_.
Responde con cualquier 2xx en menos de 10 segundos. Las entregas fallidas se reintentan a los 30 segundos, 2 minutos, 10 minutos, 1 hora, 6 horas y 24 horas; tras 20 fallos consecutivos el endpoint se desactiva y se avisa por email al propietario y a los admins. Una entrega puede repetirse: deduplica con webhook-id.
Los destinos deben ser URLs https públicas en el puerto 443 u 8443. Se rechazan redirecciones, credenciales en la URL y direcciones privadas o internas.
Verifica la firma
Verifica el cuerpo crudo de la petición antes de parsearlo. Las librerías oficiales lo hacen por ti; las versiones manuales no necesitan dependencias.
Con la librería oficial
# pip install standardwebhooks
import os
from standardwebhooks import Webhook, WebhookVerificationError
wh = Webhook(os.environ["CREATIVOX_WEBHOOK_SECRET"]) # whsec_...
def handle(raw_body: bytes, headers: dict):
try:
event = wh.verify(raw_body, headers) # checks signature and timestamp
except WebhookVerificationError:
return 400
# event["type"] is "generation.completed" or "generation.failed"
return 200// npm install standardwebhooks
import { Webhook } from "standardwebhooks";
const wh = new Webhook(process.env.CREATIVOX_WEBHOOK_SECRET); // whsec_...
export function handle(rawBody, headers) {
try {
const event = wh.verify(rawBody, headers); // checks signature and timestamp
// event.type is "generation.completed" or "generation.failed"
return 200;
} catch {
return 400;
}
}Sin dependencias
import base64, hashlib, hmac, os, time
SECRET = os.environ["CREATIVOX_WEBHOOK_SECRET"] # whsec_...
KEY = base64.b64decode(SECRET.removeprefix("whsec_"))
def verify(raw_body: bytes, headers: dict) -> bool:
msg_id = headers["webhook-id"]
ts = headers["webhook-timestamp"]
if abs(time.time() - int(ts)) > 300: # replay window: 5 minutes
return False
signed = f"{msg_id}.{ts}.".encode() + raw_body
expected = base64.b64encode(hmac.new(KEY, signed, hashlib.sha256).digest()).decode()
for part in headers["webhook-signature"].split(" "):
version, _, sig = part.partition(",")
if version == "v1" and hmac.compare_digest(sig, expected):
return True
return Falseimport { createHmac, timingSafeEqual } from "node:crypto";
const KEY = Buffer.from(process.env.CREATIVOX_WEBHOOK_SECRET.replace(/^whsec_/, ""), "base64");
export function verify(rawBody, headers) {
const id = headers["webhook-id"];
const ts = headers["webhook-timestamp"];
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false; // replay window
const expected = createHmac("sha256", KEY).update(`${id}.${ts}.${rawBody}`).digest("base64");
return headers["webhook-signature"].split(" ").some((part) => {
const [version, sig] = part.split(",");
const a = Buffer.from(sig ?? "");
const b = Buffer.from(expected);
return version === "v1" && a.length === b.length && timingSafeEqual(a, b);
});
}Configurar MCP
El servidor MCP remoto permite que agentes de IA creen productos, suban o importen imágenes, generen imágenes y lean tu biblioteca con la misma clave API y los mismos scopes. Endpoint: https://api.creativox.app/mcp
Claude Code
claude mcp add --transport http creativox https://api.creativox.app/mcp --header "Authorization: Bearer $CREATIVOX_API_KEY"Codex
Archivo: ~/.codex/config.toml
[mcp_servers.creativox]
url = "https://api.creativox.app/mcp"
bearer_token_env_var = "CREATIVOX_API_KEY"Cursor
Archivo: .cursor/mcp.json
{
"mcpServers": {
"creativox": {
"url": "https://api.creativox.app/mcp",
"headers": {
"Authorization": "Bearer ${env:CREATIVOX_API_KEY}"
}
}
}
}El inicio de sesión con OAuth (para los conectores de claude.ai y ChatGPT) llegará próximamente. Por ahora usa una clave API.
Referencia de la API
Generada a partir del documento OpenAPI en vivo. URL base: https://api.creativox.app Documento OpenAPI legible por máquinas
billing
GET/api/v1/billing/balanceRead Billing Balance
Scopes: account:read
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| balance | integer | sí | |
| plan | string | sí | |
| billing_status | BillingStatus | no | |
| monthly_quota | integer | null | no | |
| promo_label | string | null | no |
Respuesta 422 Validation Error
generations
GET/api/v1/generationsList Generations
Scopes: generations:read
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| limit (query) | integer | no | |
| offset (query) | integer | no | |
| status (query) | GenerationStatus | null | no | |
| product_id (query) | string (uuid) | null | no |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| items | array<GenerationRead> | sí | |
| items[].id | string (uuid) | sí | |
| items[].workspace_id | string (uuid) | sí | |
| items[].user_id | string (uuid) | sí | |
| items[].product_id | string (uuid) | null | sí | |
| items[].parent_id | string (uuid) | null | sí | |
| items[].prompt | string | sí | |
| items[].provider | string | sí | |
| items[].model | string | sí | |
| items[].type | string | sí | |
| items[].status | GenerationStatus | sí | |
| items[].format | 1:1 | 9:16 | 16:9 | 4:3 | 3:4 | 4:5 | sí | |
| items[].image_format | string | sí | Encoded image format (e.g. png). |
| items[].output_urls | array<string> | sí | |
| items[].outputs | array<GenerationOutput> | no | |
| items[].outputs[].id | string | sí | |
| items[].outputs[].url | string | sí | |
| items[].outputs[].preview_url | string | null | no | |
| items[].preview_url | string | null | no | |
| items[].metadata | object | sí | |
| items[].credits_consumed | integer | sí | |
| items[].is_favorite | boolean | sí | |
| items[].created_at | string (date-time) | sí | |
| items[].updated_at | string (date-time) | sí | |
| total | integer | sí |
Respuesta 422 Validation Error
POST/api/v1/generationsCreate Generation
Scopes: generations:write
Cuerpo de la petición
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| template_id | string (uuid) | null | no | |
| template_slug | string | null | no | |
| template_vars | object | no | |
| prompt | string | null | no | |
| format | 1:1 | 9:16 | 16:9 | 4:3 | 3:4 | 4:5 | sí | Output aspect ratio. |
| product_id | string (uuid) | null | no | |
| parent_id | string (uuid) | null | no | |
| type | txt2img | img2img | sí | txt2img or img2img. |
| model | string | null | no | Model ID. If omitted, uses the default model. |
| num_images | integer | no | Images to generate in this request (default 1). Must not exceed the model's `max_images` (GET /models); credits charged = per-image cost x num_images. |
| model_prompt | string | null | no | Prompt traducido a inglés en el cliente para enviar al proveedor; el prompt visible sigue siendo `prompt`. |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| workspace_id | string (uuid) | sí | |
| user_id | string (uuid) | sí | |
| product_id | string (uuid) | null | sí | |
| parent_id | string (uuid) | null | sí | |
| prompt | string | sí | |
| provider | string | sí | |
| model | string | sí | |
| type | string | sí | |
| status | GenerationStatus | sí | |
| format | 1:1 | 9:16 | 16:9 | 4:3 | 3:4 | 4:5 | sí | |
| image_format | string | sí | Encoded image format (e.g. png). |
| output_urls | array<string> | sí | |
| outputs | array<GenerationOutput> | no | |
| outputs[].id | string | sí | |
| outputs[].url | string | sí | |
| outputs[].preview_url | string | null | no | |
| preview_url | string | null | no | |
| metadata | object | sí | |
| credits_consumed | integer | sí | |
| is_favorite | boolean | sí | |
| created_at | string (date-time) | sí | |
| updated_at | string (date-time) | sí |
Respuesta 422 Validation Error
GET/api/v1/generations/{generation_id}Get Generation
Scopes: generations:read
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| generation_id (path) | string (uuid) | sí |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| workspace_id | string (uuid) | sí | |
| user_id | string (uuid) | sí | |
| product_id | string (uuid) | null | sí | |
| parent_id | string (uuid) | null | sí | |
| prompt | string | sí | |
| provider | string | sí | |
| model | string | sí | |
| type | string | sí | |
| status | GenerationStatus | sí | |
| format | 1:1 | 9:16 | 16:9 | 4:3 | 3:4 | 4:5 | sí | |
| image_format | string | sí | Encoded image format (e.g. png). |
| output_urls | array<string> | sí | |
| outputs | array<GenerationOutput> | no | |
| outputs[].id | string | sí | |
| outputs[].url | string | sí | |
| outputs[].preview_url | string | null | no | |
| preview_url | string | null | no | |
| metadata | object | sí | |
| credits_consumed | integer | sí | |
| is_favorite | boolean | sí | |
| created_at | string (date-time) | sí | |
| updated_at | string (date-time) | sí |
Respuesta 422 Validation Error
PATCH/api/v1/generations/{generation_id}/favoriteToggle Generation Favorite
Scopes: generations:write
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| generation_id (path) | string (uuid) | sí |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| is_favorite | boolean | sí |
Respuesta 422 Validation Error
library
GET/api/v1/libraryList Library
Scopes: library:read
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| limit (query) | integer | no | Page size (max 100). |
| cursor (query) | string | null | no | Opaque cursor from the previous page's `next_cursor` (base64url JSON: `created_at` ISO-8601 + `id` UUID). |
| status (query) | GenerationStatus | null | no | |
| is_favorite (query) | boolean | null | no | When set, only favorites (true) or non-favorites (false). |
| product_id (query) | string (uuid) | null | no |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| items | array<GenerationRead> | sí | |
| items[].id | string (uuid) | sí | |
| items[].workspace_id | string (uuid) | sí | |
| items[].user_id | string (uuid) | sí | |
| items[].product_id | string (uuid) | null | sí | |
| items[].parent_id | string (uuid) | null | sí | |
| items[].prompt | string | sí | |
| items[].provider | string | sí | |
| items[].model | string | sí | |
| items[].type | string | sí | |
| items[].status | GenerationStatus | sí | |
| items[].format | 1:1 | 9:16 | 16:9 | 4:3 | 3:4 | 4:5 | sí | |
| items[].image_format | string | sí | Encoded image format (e.g. png). |
| items[].output_urls | array<string> | sí | |
| items[].outputs | array<GenerationOutput> | no | |
| items[].outputs[].id | string | sí | |
| items[].outputs[].url | string | sí | |
| items[].outputs[].preview_url | string | null | no | |
| items[].preview_url | string | null | no | |
| items[].metadata | object | sí | |
| items[].credits_consumed | integer | sí | |
| items[].is_favorite | boolean | sí | |
| items[].created_at | string (date-time) | sí | |
| items[].updated_at | string (date-time) | sí | |
| next_cursor | string | null | no | Opaque cursor for the next page: base64url-encoded JSON `{"created_at":"<ISO-8601>","id":"<uuid>"}` matching the last item on this page. Omit on the first request; pass the previous `next_cursor` to continue. |
| has_more | boolean | sí | True when more items exist after `items` using `next_cursor`. |
Respuesta 422 Validation Error
mcp
POST/mcpRemote MCP (Streamable HTTP)
Stateless JSON-RPC MCP tools with workspace bearer API keys. Requests with a progress token receive SSE. Tool scopes match REST. See https://github.com/modelcontextprotocol/python-sdk for MCP clients.
Scopes: Cualquier clave válida
Respuesta 200 MCP JSON-RPC result or SSE stream
me
GET/api/v1/meRead Me
Scopes: account:read
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| workspace | KeyWorkspaceOut | sí | |
| workspace.id | string (uuid) | sí | |
| workspace.name | string | sí | |
| key | CurrentKeyOut | sí | |
| key.id | string (uuid) | sí | |
| key.name | string | sí | |
| key.prefix | string | sí | |
| key.scopes | array<string> | sí |
Respuesta 422 Validation Error
models
GET/api/v1/modelsList Available Models
Scopes: account:read
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| [].model_id | string | sí | |
| [].provider | string | sí | |
| [].display_name | string | sí | |
| [].description | string | sí | |
| [].credit_cost | integer | sí | |
| [].speed_tier | string | sí | |
| [].quality_tier | string | sí | |
| [].capabilities | array<string> | sí | |
| [].supported_aspects | array<string> | sí | |
| [].max_resolution | string | sí | |
| [].is_default | boolean | sí | |
| [].max_images | integer | sí | Largest `num_images` POST /generations accepts for this model. |
Respuesta 422 Validation Error
products
GET/api/v1/productsList Products
Scopes: products:read
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| limit (query) | integer | no | |
| offset (query) | integer | no |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| items | array<ProductRead> | sí | |
| items[].id | string (uuid) | sí | |
| items[].workspace_id | string (uuid) | sí | |
| items[].name | string | sí | |
| items[].description | string | null | sí | |
| items[].product_type | ropa | joyeria | belleza | hogar | suplementos | null | sí | |
| items[].base_images | array<string> | sí | |
| items[].image_urls | object | no | |
| items[].created_at | string (date-time) | sí | |
| items[].updated_at | string (date-time) | sí | |
| total | integer | sí |
Respuesta 422 Validation Error
POST/api/v1/productsCreate Product
Scopes: products:write
Cuerpo de la petición
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | sí | |
| description | string | null | no | |
| product_type | ropa | joyeria | belleza | hogar | suplementos | null | no |
Respuesta 201 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| workspace_id | string (uuid) | sí | |
| name | string | sí | |
| description | string | null | sí | |
| product_type | ropa | joyeria | belleza | hogar | suplementos | null | sí | |
| base_images | array<string> | sí | |
| image_urls | object | no | |
| created_at | string (date-time) | sí | |
| updated_at | string (date-time) | sí |
Respuesta 422 Validation Error
GET/api/v1/products/{product_id}Get Product
Scopes: products:read
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| workspace_id | string (uuid) | sí | |
| name | string | sí | |
| description | string | null | sí | |
| product_type | ropa | joyeria | belleza | hogar | suplementos | null | sí | |
| base_images | array<string> | sí | |
| image_urls | object | no | |
| created_at | string (date-time) | sí | |
| updated_at | string (date-time) | sí |
Respuesta 422 Validation Error
PATCH/api/v1/products/{product_id}Update Product
Scopes: products:write
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí |
Cuerpo de la petición
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | null | no | |
| description | string | null | no | |
| product_type | ropa | joyeria | belleza | hogar | suplementos | null | no |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| workspace_id | string (uuid) | sí | |
| name | string | sí | |
| description | string | null | sí | |
| product_type | ropa | joyeria | belleza | hogar | suplementos | null | sí | |
| base_images | array<string> | sí | |
| image_urls | object | no | |
| created_at | string (date-time) | sí | |
| updated_at | string (date-time) | sí |
Respuesta 422 Validation Error
DELETE/api/v1/products/{product_id}Delete Product
Scopes: products:write
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí |
Respuesta 204 Successful Response
Respuesta 422 Validation Error
POST/api/v1/products/{product_id}/confirm-uploadConfirm Upload
Scopes: products:write
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí |
Cuerpo de la petición
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| key | string | sí |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string (uuid) | sí | |
| workspace_id | string (uuid) | sí | |
| name | string | sí | |
| description | string | null | sí | |
| product_type | ropa | joyeria | belleza | hogar | suplementos | null | sí | |
| base_images | array<string> | sí | |
| image_urls | object | no | |
| created_at | string (date-time) | sí | |
| updated_at | string (date-time) | sí |
Respuesta 422 Validation Error
POST/api/v1/products/{product_id}/images/from-urlImport Product Image
Scopes: products:write
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí |
Cuerpo de la petición
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| url | string | sí |
Respuesta 202 Successful Response
Respuesta 422 Validation Error
GET/api/v1/products/{product_id}/images/imports/{import_id}Get Product Image Import
Scopes: products:read
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí | |
| import_id (path) | string (uuid) | sí |
Respuesta 200 Successful Response
Respuesta 422 Validation Error
POST/api/v1/products/{product_id}/upload-urlRequest Upload Url
Scopes: products:write
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| product_id (path) | string (uuid) | sí |
Cuerpo de la petición
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| filename | string | sí | |
| content_type | string | sí | |
| content_length | integer | sí | Exact byte size of the file to upload. It is validated against the product image size policy and bound into the presigned URL signature, so storage rejects any body of a different size. |
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| url | string | sí | |
| method | string | no | |
| headers | object | sí | |
| upload_id | string | sí | |
| curl | string | sí | |
| upload_url | string | sí | |
| key | string | sí | |
| expires_in | integer | sí |
Respuesta 422 Validation Error
templates
GET/api/v1/templatesList Templates
List active global templates (not scoped to workspace).
Scopes: account:read
Respuesta 200 Successful Response
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| items | array<TemplateRead> | sí | |
| items[].id | string (uuid) | sí | |
| items[].name | string | sí | |
| items[].slug | string | null | sí | |
| items[].category | string | sí | |
| items[].description | string | null | sí | |
| items[].prompt_template | string | sí | |
| items[].preview_url | string | null | sí | |
| items[].default_format | string | sí | |
| items[].product_types | array<string> | sí | |
| items[].formats | array<string> | sí | |
| items[].is_active | boolean | sí | |
| items[].sort_order | integer | sí | |
| items[].created_at | string (date-time) | sí | |
| items[].updated_at | string (date-time) | sí |