Webhooks

Получайте уведомления в реальном времени о завершении или сбое задач

Обзор

Webhooks allow you to receive HTTP callbacks when your image or video generation tasks complete. Instead of polling for results, you can set up a webhook endpoint to receive automatic notifications.

Доступные события

job.completedTriggered when a task completes successfully
job.failedTriggered when a task fails

API-эндпоинты

GET/api/v1/webhooks

List all your webhook configurations

Пример ответа:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "url": "https://your-server.com/webhook",
      "events": ["job.completed", "job.failed"],
      "status": "active"
    }
  ]
}

POST/api/v1/webhooks

Create a new webhook endpoint

Пример запроса:

{
  "url": "https://your-server.com/webhook",
  "events": ["job.completed", "job.failed"],
  "secret_key": "your-secret-key"
}

Параметры:

Параметр	Тип	Обязательный параметр	Описание
url	string	Требуется	Your webhook endpoint URL
events	string[]	Требуется	Events to subscribe to
secret_key	string	Опционально	Secret for signature verification

Пример ответа:

{
  "success": true,
  "data": {
    "id": 1,
    "url": "https://your-server.com/webhook",
    "events": ["job.completed", "job.failed"],
    "status": "active"
  }
}

DELETE/api/v1/webhooks/{id}

Delete a webhook endpoint

Пример ответа:

{
  "success": true,
  "data": { "id": 1 }
}

Полезная нагрузка вебхука

Формат уведомлений через вебхуки, отправляемых на ваш эндпоинт

Шапка	Описание
X-Nano-Timestamp	Unix timestamp of the request
X-Nano-Signature	HMAC-SHA256 signature for verification

Пример полезной нагрузки:

{
  "id": "job.completed:task_xxx",
  "type": "job.completed",
  "created_at": 1734948000,
  "data": {
    "task_id": "task_xxx",
    "model": "veo3",
    "status": "completed",
    "video_url": "https://cdn.example.com/video.mp4"
  }
}

Проверка подписи

const crypto = require('crypto');

function verifySignature(rawBody, signature, secret, timestamp) {
  const message = `${timestamp}.${rawBody}`;
  const expectedSig = crypto
    .createHmac('sha256', secret)
    .update(message)
    .digest('hex');
  return `v1=${expectedSig}` === signature;
}

Параметр

Тип

Обязательный параметр

Описание

url

string

Требуется

Your webhook endpoint URL

events

string[]

Требуется

Events to subscribe to

secret_key

string

Опционально

Secret for signature verification

Шапка

Описание

X-Nano-Timestamp

Unix timestamp of the request

X-Nano-Signature

HMAC-SHA256 signature for verification

{ "id": "job.completed:task_xxx", "type": "job.completed", "created_at": 1734948000, "data": { "task_id": "task_xxx", "model": "veo3", "status": "completed", "video_url": "https://cdn.example.com/video.mp4" } }