ZvenoAI
API Reference

Submit Video Generation

POST
/v1/videos

Отправляет асинхронный запрос на генерацию видео. Стоимость удерживается на балансе при создании задачи; нехватка средств — 402.

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Header Parameters

Idempotency-Key?string

Необязательный ключ повтора, до 255 символов, в пределах пользователя. Повтор с тем же ключом и тем же телом возвращает 202 с той же задачей: без второй задачи, резерва и списания. С другим телом — 409 metadata.reason=idempotency_key_reused. Ключ хранится 24 часа. Без заголовка каждый запрос создаёт новую задачу.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:8080/v1/videos" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "prompt": "string"  }'
{
  "id": "string",
  "polling_url": "string",
  "status": "string",
  "generation_id": "string",
  "unsigned_urls": [
    "string"
  ],
  "usage": {
    "cost": 0.1,
    "is_byok": true
  },
  "error": "string"
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": 0,
    "message": "string",
    "metadata": {
      "property1": null,
      "property2": null
    }
  }
}