Первая генерация

Базовый URL

Все публичные запросы отправляйте на версионированный адрес:

https://api-platform.gensta.ai/v1

/v1 — версия публичного HTTP-контракта. Совместимые изменения добавляются внутри v1; несовместимые потребуют новой основной версии.

Перед началом

Войдите на platform.gensta.ai, примите соглашение и создайте API-ключ.

1. Получите ключ проекта.Храните его только на своем сервере — не в браузере или мобильном приложении.
2. Прочитайте каталог.GET /v1/models возвращает режимы, параметры, текущую доступность и актуальные цены.
3. Создайте генерацию.Передайте стабильный Idempotency-Key, чтобы безопасно повторить запрос при потере ответа.
4. Проверяйте статус по ID.Видео генерируется асинхронно.

Создание генерации

export GENSTA_API_KEY="your-secret-key"

curl --silent --show-error --fail-with-body \
  -X POST "https://api-platform.gensta.ai/v1/generations" \
  -H "Authorization: Bearer $GENSTA_API_KEY" \
  -H "Idempotency-Key: order-8493-shot-1" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-3.0",
  "mode": "text_to_video",
  "variant": "standard",
  "parameters": {
    "resolution": "720p",
    "duration_seconds": 5,
    "ratio": "16:9",
    "audio": true,
    "prompt_extend": false,
    "watermark": false
  },
  "input": {
    "prompt": "A paper boat crosses a rain puddle, macro lens"
  }
}'

При успехе API отвечает HTTP 202, возвращает id, статус queued и сумму, временно зарезервированную на балансе. Сразу сохраните ID.

Получение результата

curl --silent --show-error --fail-with-body \
  "https://api-platform.gensta.ai/v1/generations/$GENERATION_ID" \
  -H "Authorization: Bearer $GENSTA_API_KEY"

Первую проверку сделайте примерно через 5 секунд, далее — раз в 10–15 секунд. При временных сетевых ошибках постепенно увеличивайте интервал. При succeeded результат находится в artifacts[].download_url.