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

Desarrolladores

Iniciar una generación

POST
/generations

Inicia una generación y cobra sus créditos cuando se acepta. Las entradas son URLs https públicas: una publicUrl de create_upload_target o cualquier URL https pública. Si la generación falla, se devuelven sus créditos.

Asíncrona: responde de inmediato con el creationId; consulta get_generation_status hasta que status sea succeeded o failed.

Envía una cabecera Idempotency-Key para que los reintentos sean seguros: la misma clave con el mismo cuerpo devuelve el primer resultado; con otro cuerpo, 409.

Autorización

headerAutorizaciónBearer <token>

Una API Key creada en la configuración de la cuenta, enviada como Authorization: Bearer <key>. Incluye los Scopes seleccionados al crearla.

Parámetros de cabecera

Idempotency-Key?string

Una clave del cliente, única por solicitud.

Longitud1 <= length <= 255

Cuerpo de la solicitud

application/json
  1. body
submission*|||
originalPrompt?string
Longitud1 <= length

Cuerpo de la respuesta

Correcto.

application/json
  1. response
creationId*string
status*string
Valor en"generating""succeeded""failed"
remainingCredits?integer
Rango-9007199254740991 <= value <= 9007199254740991
Solicitud de ejemplo
curl -X POST 'https://ximagesplitter.com/api/v1/generations' \
  -H 'Content-Type: application/json' \
  -d '{
  "submission": {
    "mode": "image",
    "modelKey": "seedream-5-5",
    "prompt": "string",
    "assets": [
      {
        "slotId": "string",
        "url": "http://example.com"
      }
    ],
    "options": {
      "property1": "string",
      "property2": "string"
    },
    "operation": "text-to-image"
  }
}'
Respuesta de ejemplo
{
  "creationId": "string",
  "status": "generating",
  "remainingCredits": -9007199254740991
}