Documentación API

Introducción

La API de Zubnet te da acceso programático a más de 350 modelos de IA para generación de texto, imágenes, video, música, voz y código. Es completamente compatible con la especificación de la API de OpenAI — si ya estás usando OpenAI, puedes cambiar a Zubnet modificando tu URL base y clave API.

URL Base

https://api.zubnet.com/v1

Inicio Rápido

# Using curl
curl https://api.zubnet.com/v1/chat/completions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# Using Python with OpenAI SDK
from openai import OpenAI

client = OpenAI(
    api_key="your-zubnet-api-key",
    base_url="https://api.zubnet.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

Autenticación

Todas las solicitudes a la API requieren autenticación mediante un token Bearer en el encabezado Authorization.

Authorization: Bearer YOUR_API_KEY

Puedes generar claves API desde la configuración de tu cuenta. Mantén tus claves seguras — otorgan acceso completo a tu cuenta.

Uso de Claves Propias de Proveedores (BYOK)

También puedes usar tus propias claves API de proveedores como Anthropic, Google y más de 40 otros. Agrégalas en la configuración de tu workspace y se usarán automáticamente para solicitudes a esos proveedores — sin ningún recargo.

Modelos

Lista todos los modelos disponibles.

curl https://api.zubnet.com/v1/models \
  -H "Authorization: Bearer $ZUBNET_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-20250514",
      "object": "model",
      "created": 1699900000,
      "owned_by": "anthropic"
    },
    {
      "id": "deepseek-chat",
      "object": "model",
      "created": 1699900000,
      "owned_by": "deepseek"
    },
    ...
  ]
}

Completaciones de Chat

Crea una completación de chat. Este es el endpoint principal para generación de texto, compatible con el formato de completaciones de chat de OpenAI.

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://api.zubnet.com/v1/chat/completions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the capital of France?"}
    ],
    "temperature": 0.7,
    "max_tokens": 150
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1699900000,
  "model": "claude-sonnet-4-20250514",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}

Generación de Código

Genera código a partir de un prompt en lenguaje natural. Devuelve una respuesta en streaming vía Server-Sent Events (SSE).

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/ai/completions/code \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A function that checks if a number is prime",
    "language": "python"
  }'

{
  "object": "code_document",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "claude-sonnet-4-20250514",
  "cost": 1,
  "title": "Prime Number Checker",
  "content": "def is_prime(n): ..."
}

Generación de Imágenes

Genera imágenes a partir de prompts de texto usando modelos de FLUX, Stable Diffusion, Ideogram y más.

Modelos Disponibles

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://api.zubnet.com/v1/images/generations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro-1.1-ultra",
    "prompt": "A serene mountain lake at sunset, photorealistic",
    "n": 1,
    "size": "1024x1024"
  }'

{
  "created": 1699900000,
  "data": [
    {
      "url": "https://cdn.zubnet.ai/files/abc123.png",
      "revised_prompt": "A serene mountain lake..."
    }
  ]
}

Generación de Videos

Genera videos a partir de prompts de texto o imágenes. Soporta flujos de trabajo de texto a video, imagen a video y video a video.

Modelos Disponibles

Cuerpo de la Solicitud

Ejemplo: Texto a Video

curl https://app.zubnet.ai/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A drone shot flying over a coral reef at golden hour",
    "aspect_ratio": "16:9",
    "duration": 8
  }'

Ejemplo: Imagen a Video

curl https://app.zubnet.ai/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=kling-v2-5-turbo" \
  -F "prompt=Camera slowly zooms in" \
  -F "frames=@my-image.png"

{
  "object": "video",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-generate-001",
  "state": "processing",
  "progress": 0,
  "cost": 5,
  "output_file": null,
  "created_at": "2026-02-25T12:00:00Z"
}

Comprensión de Video

Analice contenido de video con IA. Envíe una URL de video para análisis y consulte los resultados. Soporta múltiples tipos de análisis.

Enviar un video para análisis por IA. Retorna un identificador de tarea que puede consultar para obtener resultados.

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/ai/video-understanding \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "type": "summary"
  }'

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}

Verificar el estado de una tarea de análisis de video.

{
  "status": "completed",
  "result": {
    "type": "summary",
    "content": "El video muestra una demostración de producto..."
  }
}

Composición Musical

Genera música original a partir de descripciones de texto, letras o etiquetas de estilo.

Modelos Disponibles

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/ai/compositions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v5",
    "prompt": "An upbeat synthwave track about coding at 3am",
    "tags": "synthwave, electronic, upbeat",
    "instrumental": true
  }'

[
  {
    "object": "composition",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "model": "suno/v5",
    "title": "Midnight Code",
    "tags": "synthwave, electronic, upbeat",
    "cost": 2,
    "output_file": {
      "url": "https://cdn.zubnet.ai/files/abc123.mp3"
    }
  },
  {
    "object": "composition",
    "id": "550e8400-e29b-41d4-a716-446655440001",
    // ... segunda variante
  }
]

Efectos de Sonido

Generar efectos de sonido a partir de descripciones de texto.

Cuerpo de la solicitud

Ejemplo de solicitud

curl https://app.zubnet.ai/api/ai/sound-effects \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sound-effect-model",
    "prompt": "Thunder rumbling in the distance followed by heavy rain"
  }'

{
  "object": "sound_effect",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "sound-effect-model",
  "cost": 1,
  "output_file": {
    "url": "https://cdn.zubnet.ai/files/abc123.mp3"
  }
}

Texto a Voz

Convierte texto en audio de voz con sonido natural usando voces de ElevenLabs, Cartesia, Speechify y más.

Ejemplo de Solicitud

curl https://api.zubnet.com/v1/audio/speech \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1-hd",
    "input": "Welcome to Zubnet, the future of AI.",
    "voice": "nova"
  }' --output speech.mp3

Transcripción

Transcribe audio a texto.

Ejemplo de Solicitud

curl https://api.zubnet.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "model=whisper-1" \
  -F "file=@recording.mp3"

{
  "object": "transcription",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "whisper-1",
  "content": "Hello, this is a test recording..."
}

Aislamiento de Voz

Extrae voces limpias del audio, eliminando ruido de fondo y música. Desarrollado por ElevenLabs.

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/ai/isolated-voices \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@noisy-recording.mp3"

{
  "object": "isolated_voice",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 1,
  "input_file": {
    "url": "https://cdn.zubnet.ai/files/input.mp3"
  },
  "output_file": {
    "url": "https://cdn.zubnet.ai/files/isolated.mp3"
  }
}

Separación de Pistas

Separa el audio en pistas individuales (voces, batería, bajo, guitarra, piano, otros). Desarrollado por ElevenLabs.

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/ai/stem-separations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@song.mp3"

{
  "object": "stem_separation",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cost": 1,
  "input_file": {
    "url": "https://cdn.zubnet.ai/files/song.mp3"
  },
  "output_file": {
    "url": "https://cdn.zubnet.ai/files/stems.zip"
  }
}

Voces

Cree y gestione voces personalizadas para la síntesis de voz.

Crear una voz personalizada.

Listar todas las voces disponibles en su espacio de trabajo.

Actualizar una voz personalizada.

Eliminar una voz personalizada.

Embeddings

Crea embeddings de texto para búsqueda semántica y similitud.

Ejemplo de Solicitud

curl https://api.zubnet.com/v1/embeddings \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

Bases de conocimiento

Crea y gestiona bases de conocimiento para la generación aumentada por recuperación (RAG). Sube documentos (PDF, DOCX, TXT, Markdown) o añade URLs y texto sin formato, y luego consúltalos en tus completions de chat.

Crear una nueva base de conocimiento.

Cuerpo de la solicitud

Ejemplo: Crear una base de conocimiento

curl https://app.zubnet.ai/api/knowledge-bases \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My KB",
    "description": "Optional description"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My KB",
  "description": "Optional description",
  "status": "active"
}

Listar todas las bases de conocimiento en tu espacio de trabajo.

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "My KB",
    "description": "Optional description",
    "status": "active"
  },
  ...
]

Obtener los detalles de una base de conocimiento específica, incluyendo sus documentos.

Eliminar una base de conocimiento y todos sus documentos.

Ingerir un documento en una base de conocimiento. Soporta carga de archivos, URLs y texto sin formato.

Cuerpo de la solicitud

Ejemplo: Ingerir un archivo

curl https://app.zubnet.ai/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -F "file=@report.pdf"

Ejemplo: Ingerir una URL

curl https://app.zubnet.ai/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Zubnet Docs",
    "type": "url",
    "url": "https://zubnet.ai/developers.html"
  }'

Ejemplo: Ingerir texto sin formato

curl https://app.zubnet.ai/api/knowledge-bases/550e8400-.../documents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Company Policy",
    "type": "text",
    "content": "All employees must complete security training annually..."
  }'

Listar todos los documentos de una base de conocimiento.

Eliminar un documento específico de una base de conocimiento.

Leer el contenido textual extraído de un documento específico.

Reranking

Reordenar una lista de documentos por relevancia respecto a una consulta. Útil para mejorar resultados de búsqueda, pipelines RAG y sistemas de recomendación.

Modelos disponibles

Cuerpo de la solicitud

Ejemplo de solicitud

curl https://api.zubnet.ai/v1/reranking \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-v4.0-pro",
    "query": "How do I reset my password?",
    "documents": [
      "To reset your password, go to Settings > Security > Change Password.",
      "Our pricing plans start at $9/month for individuals.",
      "Password requirements: minimum 8 characters, one uppercase letter.",
      "Contact support at help@example.com for account issues."
    ],
    "top_n": 3
  }'

{
  "object": "list",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.953
    },
    {
      "index": 2,
      "relevance_score": 0.714
    },
    {
      "index": 3,
      "relevance_score": 0.389
    }
  ],
  "model": "rerank-v4.0-pro"
}

Biblioteca

La biblioteca es donde vive todo el contenido generado — imágenes, videos, composiciones, documentos de código, transcripciones y más. Úsela para listar elementos, verificar el estado de generación asíncrona, actualizar metadatos y gestionar su contenido.

Listar elementos en su biblioteca por tipo de contenido.

Tipos de Contenido

Parámetros de Consulta

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "object": "video",
      "model": "veo-3.1-generate-001",
      "title": "Coral reef drone shot",
      "state": 3,
      "progress": 100,
      "cost": 5,
      "output_file": {
        "url": "https://cdn.zubnet.ai/files/abc123.mp4",
        "size": 8421376,
        "extension": "mp4"
      },
      "created_at": "2026-03-01T12:00:00Z"
    },
    ...
  ]
}

Obtener un elemento de la biblioteca por ID. Este es el endpoint principal para consultar el estado de generación asíncrona.

Estados de Generación

Patrón de Consulta

# 1. Iniciar generación asíncrona
curl -X POST https://app.zubnet.ai/api/ai/videos \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1-generate-001", "prompt": "Un arrecife de coral"}'
# Retorna: {"id": "550e8400-...", "state": 1, ...}

# 2. Consultar estado hasta completar
curl https://app.zubnet.ai/api/library/videos/550e8400-... \
  -H "Authorization: Bearer $ZUBNET_API_KEY"
# Retorna: {"state": 2, "progress": 45, ...}  (procesando)
# Retorna: {"state": 3, "progress": 100, "output_file": {"url": "..."}}  (listo)

Actualizar los metadatos de un elemento de la biblioteca.

Eliminar un elemento de la biblioteca y sus archivos asociados.

Obtener el total de elementos para un tipo de contenido. Soporta los mismos filtros query y model que el endpoint de listado.

Asistentes

Los asistentes son preajustes de chat reutilizables con un nombre, modelo, prompt de sistema y configuraciones personalizados. Úselos para crear personas de IA especializadas para diferentes tareas.

Crear un nuevo asistente.

Listar todos los asistentes en su espacio de trabajo.

Actualizar la configuración de un asistente (nombre, modelo, prompt de sistema, ajustes).

Eliminar un asistente.

Tienda MCP

Explore y active servidores MCP (Model Context Protocol) para dar a sus agentes capacidades de herramientas extendidas — desde búsqueda web y acceso a datos hasta ejecución de código e integraciones de terceros.

Explorar el catálogo de servidores MCP.

Parámetros de Consulta

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "name": "GitHub",
      "description": "Acceder a repositorios, issues y pull requests de GitHub",
      "category": "developer",
      "config_schema": [
        {"name": "api_key", "type": "secret", "label": "API Key", "required": true}
      ],
      "tools": ["list_repos", "create_issue", "search_code"],
      "is_official": true
    },
    ...
  ]
}

Activar un servidor MCP para su espacio de trabajo. Proporcione valores de configuración (claves API, etc.) según lo definido por el config_schema del servidor.

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/mcp-store/activations \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server_id": "550e8400-e29b-41d4-a716-446655440000",
    "config": {
      "api_key": "ghp_xxxxxxxxxxxx"
    }
  }'

{
  "id": "act-uuid-...",
  "server_id": "550e8400-...",
  "status": 1,
  "config": {
    "api_key": "••••••••"
  },
  "server": {
    "name": "GitHub",
    ...
  },
  "created_at": "2026-03-01T12:00:00Z"
}

Listar todos los servidores MCP activados en su espacio de trabajo.

Actualizar la configuración o estado de una activación.

Desactivar un servidor MCP de su espacio de trabajo.

Agentes

Cree y gestione agentes de IA autónomos que operan a través de canales de comunicación. Los agentes pueden responder mensajes en Telegram y Discord, ejecutarse mediante disparadores programados y aprovechar bases de conocimiento y servidores MCP para capacidades extendidas.

Crear un nuevo agente.

Cuerpo de la solicitud

Ejemplo de solicitud

curl https://app.zubnet.ai/api/agents \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Bot",
    "model": "claude-sonnet-4-20250514",
    "system_prompt": "You are a friendly support agent. Answer questions clearly and concisely.",
    "mode": "advanced"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Support Bot",
  "slug": "support-bot",
  "avatar": null,
  "model": "claude-sonnet-4-20250514",
  "system_prompt": "You are a friendly support agent...",
  "status": 1,
  "mode": "advanced",
  "permissions": {
    "time_windows": [],
    "frequency_cap": {
      "max_messages_per_hour": 60,
      "max_messages_per_day": 500
    },
    "channel_preferences": {},
    "allowed_actions": {
      "can_use_tools": true,
      "can_access_kb": true,
      "max_tool_calls_per_message": 5
    }
  },
  "cost": 0,
  "last_active_at": null,
  "created_at": 1709136000,
  "updated_at": null,
  "user": {
    "id": "a1b2c3d4-...",
    "first_name": "Jane",
    "last_name": "Doe",
    "avatar": "https://cdn.zubnet.ai/files/avatar.jpg"
  },
  "channels": []
}

Listar todos los agentes del espacio de trabajo. Soporta paginación y filtrado.

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-...",
      "name": "Support Bot",
      "slug": "support-bot",
      "model": "claude-sonnet-4-20250514",
      "status": 1,
      "mode": "advanced",
      "cost": 12.50,
      "last_active_at": 1709222400,
      "created_at": 1709136000,
      ...
    }
  ]
}

Obtener los detalles completos de un agente, incluyendo sus canales, servidores MCP y bases de conocimiento vinculados.

Actualizar un agente. Todos los campos son opcionales — solo se modifican los campos proporcionados.

Cuerpo de la solicitud

Objeto de Permisos

{
  "permissions": {
    "time_windows": [
      {
        "days": [1, 2, 3, 4, 5],  // 0=Dom, 6=Sáb
        "timezone": "America/Mexico_City",
        "start_hour": 9,            // 0-23
        "end_hour": 17              // 1-24
      }
    ],
    "frequency_cap": {
      "max_messages_per_hour": 60,    // 1-1000
      "max_messages_per_day": 500     // 1-10000
    },
    "channel_preferences": {
      "default_channel": "telegram",
      "proactive_channels": ["telegram", "discord"]
    },
    "allowed_actions": {
      "can_use_tools": true,
      "can_access_kb": true,
      "max_tool_calls_per_message": 5  // 0-50
    }
  }
}

Eliminar un agente. Esto también elimina todos sus canales, disparadores, mensajes e integraciones.

Integraciones

Vincular una base de conocimiento a un agente para respuestas con RAG. Cuerpo: { "knowledge_base_id": "uuid" }

Desvincular una base de conocimiento de un agente.

Vincular un servidor MCP a un agente para herramientas extendidas. Cuerpo: { "activation_id": "uuid" }

Desvincular un servidor MCP de un agente.

Recuperar el historial de conversaciones de un agente.

{
  "object": "list",
  "data": [
    {
      "id": "msg-uuid-...",
      "direction": "inbound",
      "content": "How do I reset my password?",
      "external_user_name": "john_doe",
      "cost": 0,
      "model": null,
      "created_at": 1709222400
    },
    {
      "id": "msg-uuid-...",
      "direction": "outbound",
      "content": "Go to Settings > Security > Change Password...",
      "cost": 0.25,
      "model": "claude-sonnet-4-20250514",
      "created_at": 1709222401
    }
  ]
}

Canales de Agente

Conecte agentes a plataformas de comunicación. Cada agente soporta un canal por tipo (un bot de Telegram, un bot de Discord).

Agregar un canal de comunicación a un agente.

Cuerpo de la solicitud

Ejemplo de solicitud

curl https://app.zubnet.ai/api/agents/550e8400-.../channels \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "telegram",
    "token": "7123456789:AAH..."
  }'

{
  "id": "ch-uuid-...",
  "type": "telegram",
  "status": 1,
  "metadata": {},
  "last_error": null,
  "last_message_at": null,
  "created_at": 1709136000
}

Listar todos los canales conectados a un agente.

Eliminar un canal de un agente.

Disparadores de Agente

Automatice las acciones de los agentes con disparadores. Los disparadores programados usan expresiones cron para ejecutarse en horarios específicos; los disparadores de evento se activan en respuesta a eventos externos.

Crear un disparador automatizado para un agente.

Cuerpo de la solicitud

Ejemplo: Disparador de resumen diario

curl https://app.zubnet.ai/api/agents/550e8400-.../triggers \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Summary",
    "type": "scheduled",
    "prompt": "Summarize the key metrics for today and send them to the team.",
    "cron_expression": "0 18 * * 1-5",
    "timezone": "America/Mexico_City"
  }'

{
  "id": "tr-uuid-...",
  "name": "Daily Summary",
  "type": "scheduled",
  "status": 1,
  "cron_expression": "0 18 * * 1-5",
  "timezone": "America/Mexico_City",
  "prompt": "Summarize the key metrics for today...",
  "channel_id": null,
  "last_run_at": null,
  "next_run_at": 1709236800,
  "run_count": 0,
  "created_at": 1709136000
}

Listar todos los disparadores de un agente.

Actualizar un disparador. Todos los campos son opcionales. Establezca status a 0 para desactivar o 1 para activar.

Eliminar un disparador.

Espacios de Trabajo

Los espacios de trabajo son la unidad organizativa de su equipo. Cada espacio tiene su propio saldo de créditos, suscripción, claves API y miembros. Gestione espacios, invite miembros y realice seguimiento del uso.

Crear un nuevo espacio de trabajo.

{
  "id": "550e8400-...",
  "name": "Mi Equipo",
  "subscription": null,
  "api_spending_limit": null,
  "api_spending_current": 0,
  "owner": { "id": "...", "email": "..." },
  "created_at": "2026-03-01T12:00:00Z"
}

Actualizar la configuración de un espacio de trabajo. Requiere permiso de gestión.

Eliminar un espacio de trabajo. Requiere permiso de gestión.

Invitar a un usuario a unirse al espacio por correo electrónico. Máximo 20 invitaciones pendientes por espacio.

Cancelar una invitación pendiente.

Eliminar un miembro del espacio, o abandonar el espacio usando su propio ID de usuario.

Listar estadísticas de uso agregadas. Paginación por cursor.

Listar entradas de uso detalladas (elementos completados con costo > 0). Cada entrada incluye tipo, modelo, título, costo y marca de tiempo.

Obtener el total de elementos de uso.

Conversaciones

Las conversaciones agrupan mensajes de chat en sesiones. Cree primero una conversación y luego envíe mensajes. Las conversaciones también se pueden gestionar a través de la API de Biblioteca usando el tipo conversations.

Crear una nueva conversación. Retorna el objeto conversación con una lista de mensajes vacía.

{
  "object": "conversation",
  "id": "550e8400-...",
  "title": null,
  "cost": 0,
  "messages": [],
  "created_at": "2026-03-01T12:00:00Z"
}

Enviar un mensaje a una conversación y recibir una respuesta de IA vía Server-Sent Events (SSE). Consulte la sección Completaciones de Chat para detalles del formato SSE.

Cuerpo de la Solicitud

Ejemplo de Solicitud

curl https://app.zubnet.ai/api/ai/conversations/550e8400-.../messages \
  -H "Authorization: Bearer $ZUBNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "content": "Explique la computación cuántica en términos simples"
  }'

Cuenta

Gestione su perfil de usuario y genere claves API programáticamente.

Actualizar su información de perfil.

Generar una nueva clave API. Requiere confirmación de contraseña. La clave completa se muestra solo una vez en esta respuesta — guárdela de forma segura.

{
  "id": "550e8400-...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "api_key": "zub_live_a1b2c3d4e5f6..."
}

Facturación

Explore los planes disponibles, consulte el historial de pedidos, inicie un pago y gestione suscripciones.

Listar los planes de suscripción disponibles.

Listar los pedidos del espacio de trabajo actual. Paginación por cursor.

Iniciar un pago para un plan de suscripción o compra de créditos. Requiere permiso de gestión del espacio.

Cancelar la suscripción del espacio de trabajo actual. Requiere permiso de gestión.

Reportes de Contenido

Reportar contenido inapropiado o que viola las políticas en la biblioteca pública.

Enviar un reporte de contenido. Cada usuario solo puede reportar un elemento dado una vez.

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

Errores

La API usa códigos de estado HTTP estándar y devuelve mensajes de error detallados.

{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Límites de Solicitud

Los límites de solicitud varían según el plan. Los encabezados se incluyen en cada respuesta:

Si alcanzas un límite de solicitudes, espera hasta el momento de restablecimiento o contáctanos para aumentar tus límites.