Logo de X Image SplitterX Image Splitter
Logo de X Image SplitterX Image Splitter

Desarrolladores

Introducción para desarrolladores

Las formas de crear sobre %APP_NAME%: la API REST, MCP para agentes de IA, OAuth para apps, webhooks y documentos de descubrimiento legibles por máquinas.

Todo lo que puedes hacer en la web con una cuenta (generar imágenes con Seedream 5.5, mejorar prompts, gestionar creaciones, consultar créditos, iniciar la compra de un paquete de créditos, escribir a soporte) está disponible también para tu propio código y para agentes de IA, con las mismas reglas y los mismos precios. El divisor de imágenes funciona solo en el navegador; las integraciones reciben un enlace que abre en él una imagen generada.

Superficies de integración

SuperficiePara qué sirveAutenticación
API RESTScripts, backends y automatizacionesAPI Key o token de OAuth
MCPAgentes de IA y asistentes que conectan vía MCPToken de OAuth
OAuthConnected Apps que actúan en nombre de usuariosCódigo de autorización + PKCE
WebhooksNotificaciones de eventos (finalización de generación, pagos)Entregas firmadas
DescubrimientoInspección de capacidades del producto sin necesidad de cuentaNinguna

Todas las superficies se generan a partir del registro único de Integration Actions, garantizando paridad total entre operaciones REST, herramientas MCP y definiciones OpenAPI.

Elección de credencial

  • Scripts y backends directos: acceden a la API REST con una API Key creada en los ajustes de cuenta.
  • Aplicaciones y agentes de IA de terceros: se autentican mediante OAuth 2.1, solicitando el consentimiento del usuario para Scopes específicos.

Ambos tipos de credencial portan Scopes, como generations:write o credits:read. Cada operación exige un Scope concreto; las credenciales que no lo tengan reciben un error 403 Forbidden (insufficient_scope).

Un flujo de generación típico

  1. GET /models para ver el modelo, sus operaciones, opciones y límites.
  2. POST /generations/estimate para comprobar el coste en créditos.
  3. POST /uploads y un PUT del archivo, si quieres añadir imágenes de referencia (gratis, hasta 10).
  4. POST /generations para iniciar el trabajo. Devuelve un creationId al instante.
  5. Espera al webhook generation.completed, o consulta GET /generations/{creationId} hasta que status sea succeeded o failed.
  6. Dale al usuario un enlace de splitterLinks de la respuesta para dividir la imagen en su navegador.

La referencia de la API REST recorre este flujo con ejemplos completos.

Límites financieros y traspasos al usuario

Los agentes y clientes de la API pueden iniciar la compra de un paquete de créditos, pero no pagar. La compra devuelve una URL que el usuario abre para pagar. Ya no se venden suscripciones; los cambios en una suscripción existente también devuelven una URL de confirmación. Las operaciones de administración nunca se exponen en APIs públicas.

Documentos de descubrimiento

Estos documentos públicos describen el producto a herramientas y rastreadores, y no necesitan credencial:

  • https://ximagesplitter.com/api/v1/openapi.json: el documento OpenAPI 3.1 de la API REST.
  • https://ximagesplitter.com/.well-known/product-profile.json: el modelo, los precios de los paquetes de créditos, el coste de la generación y los enlaces en un solo documento JSON.
  • https://ximagesplitter.com/llms.txt y https://ximagesplitter.com/llms-full.txt: esta documentación para modelos de lenguaje.
  • Cada página de la documentación en Markdown: añade .md a su dirección o usa Copiar Markdown en la parte superior de la página.