Быстрый старт

Этот гайд проведёт тебя от регистрации до первого сгенерированного клипа. Понадобится только терминал и любой язык программирования.

1. Зарегистрируйся и получи ключ

   Открой panel.nexusapi.dev, создай аккаунт по email, перейди в раздел API ключи и нажми «Выпустить новый ключ». Сохрани полный секрет — он показывается ровно один раз.

   Пополни баланс ключа через бота или попроси админа (если у тебя пробный доступ).

2. Выбери модель

   Все доступные модели и цены — на странице каталога. Для первого запроса возьмём veo-3-fast — самый дешёвый видео-генератор, ~7-9 секунд клипа за минуту обработки.

3. Отправь запрос на генерацию

   POST /generate принимает params с именем модели и её параметрами. В ответе — task_id.

   curl

   curl -X POST https://nexusapi.dev/generate \
     -H "Authorization: Bearer $NEXUS_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "params": {
         "model_name": "veo-3-fast",
         "prompt": "Кот играет на пианино в джаз-баре",
         "duration": 8,
         "aspect_ratio": "16:9"
       }
     }'

   Python

   import os, requests
   
   resp = requests.post(
       "https://nexusapi.dev/generate",
       headers={"Authorization": f"Bearer {os.environ['NEXUS_KEY']}"},
       json={
           "params": {
               "model_name": "veo-3-fast",
               "prompt": "Кот играет на пианино в джаз-баре",
               "duration": 8,
               "aspect_ratio": "16:9",
           }
       },
   )
   task_id = resp.json()["task_id"]
   print(task_id)

   Node.js

   const resp = await fetch("https://nexusapi.dev/generate", {
     method: "POST",
     headers: {
       "Authorization": `Bearer ${process.env.NEXUS_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
       params: {
         model_name: "veo-3-fast",
         prompt: "Кот играет на пианино в джаз-баре",
         duration: 8,
         aspect_ratio: "16:9",
       },
     }),
   });
   const { task_id } = await resp.json();
   console.log(task_id);

   Go

   body := strings.NewReader(`{
     "params": {
       "model_name": "veo-3-fast",
       "prompt": "Кот играет на пианино в джаз-баре",
       "duration": 8,
       "aspect_ratio": "16:9"
     }
   }`)
   req, _ := http.NewRequest("POST", "https://nexusapi.dev/generate", body)
   req.Header.Set("Authorization", "Bearer "+os.Getenv("NEXUS_KEY"))
   req.Header.Set("Content-Type", "application/json")
   resp, _ := http.DefaultClient.Do(req)
   defer resp.Body.Close()

   Ключ — в env-переменную

   Никогда не зашивай ключ в код. export NEXUS_KEY=... в shell или .env-файле — и читаешь через os.environ/process.env.

4. Дождись результата

   Видео-задача идёт от ~30 секунд до нескольких минут. Опрашивай GET /tasks/{task_id} каждые 3-5 секунд, пока status не станет completed (или failed).

   curl

   curl https://nexusapi.dev/tasks/$TASK_ID \
     -H "Authorization: Bearer $NEXUS_KEY"

   Python

   import time
   while True:
       r = requests.get(
           f"https://nexusapi.dev/tasks/{task_id}",
           headers={"Authorization": f"Bearer {os.environ['NEXUS_KEY']}"},
       ).json()
       if r["status"] in ("completed", "failed"):
           break
       time.sleep(3)
   print(r["result"]["video_url"] if r["status"] == "completed" else r["error"])

   Node.js

   while (true) {
     const r = await fetch(`https://nexusapi.dev/tasks/${taskId}`, {
       headers: { Authorization: `Bearer ${process.env.NEXUS_KEY}` },
     }).then((r) => r.json());
     if (r.status === "completed" || r.status === "failed") {
       console.log(r);
       break;
     }
     await new Promise((res) => setTimeout(res, 3000));
   }

5. Используй результат

   На completed в result лежит ссылка на сгенерированное видео в S3 — храни/скачивай по своему вкусу. Готово.

Без polling: webhook

Если не хочешь опрашивать — передай webhook_url прямо в params, и мы пришлём POST на твой эндпоинт, когда задача завершится. Подробнее — на странице Webhooks.