RoyalTechno AI
API ДЛЯ РОЗРОБНИКІВ

Будуй з
RoyalTechno API

Ті самі AI-моделі, що й у боті — Veo 3.1, Seedance і Nano Banana — відео ТА зображення через чистий REST API. Асинхронна відправка, опитування статусу, постійні URL у сховищі. Для батч-пайплайнів.

Отримати API-ключПовна довідка
BASE URLhttps://api.royaltechno.cc/v1
ШВИДКИЙ СТАРТ

Перший кліп за три кроки

Авторизуйся, відправ завдання та забери готове відео чи зображення, опитуючи статус.

  1. 1

    Авторизація

    Передай ключ як Authorization: Bearer. Отримай його в боті командою /api_key_new.

  2. 2

    Відправ завдання

    POST з model та блоком input (prompt, aspect_ratio). У відповідь — id завдання.

  3. 3

    Забери результат

    Опитуй GET /v1/jobs/{id}, доки status не стане succeeded.

Відео

curl https://api.royaltechno.cc/v1/jobs \  -H "Authorization: Bearer $RT_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "veo-3.1",    "input": {      "prompt": "a cinematic drone shot over snowy mountains at sunrise",      "aspect_ratio": "landscape",      "duration_sec": 8    }  }'

Зображення — той самий ендпоїнт, модель-зображення

curl https://api.royaltechno.cc/v1/jobs \  -H "Authorization: Bearer $RT_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "nano-banana-pro",    "input": {      "prompt": "a royal crown made of glass, studio lighting",      "aspect_ratio": "landscape"    }  }'
POSTВідповідь · 201 Created
{  "id": "job_3Xk9aQ2",  "object": "job",  "model": "veo-3.1",  "status": "queued",  "input": {    "prompt": "a cinematic drone shot over snowy mountains at sunrise",    "aspect_ratio": "landscape",    "duration_sec": 8  },  "cost_usd_cents": 2,  "created_at": "2026-07-29T09:41:00Z"}
GETОпитування · GET /v1/jobs/{id}
# Poll until status is succeeded | failed (ETag-aware → 304 on no change).# While queued, `queue_position` shows your place in line. Video takes# minutes — never resubmit a slow job: you would pay twice.GET https://api.royaltechno.cc/v1/jobs/job_3Xk9aQ2​{  "id": "job_3Xk9aQ2",  "status": "succeeded",  "output": {    "type": "video",    "url": "https://cdn.royaltechno.cc/saas/videos/job_3Xk9aQ2.mp4",    "mime_type": "video/mp4",    "duration_sec": 8  },  "cost_usd_cents": 2}
МОДЕЛІ

Доступні моделі

Передавай id у полі model. Повний живий список і ціни — GET /v1/pricing.

ID моделіНазваТипСпіввідношенняЦіна за генерацію
veo-3.1Veo 3.1 1080pvideo16:9 · 9:16$0.05
omni-flashGemini Omni Flashvideo16:9 · 9:16$0.04+
seedance-2.0-miniSeedance 2.0 Minivideo16:9 · 9:16$0.40+
seedance-2.0-fastSeedance 2.0 Fastvideo16:9 · 9:16$0.45+
seedance-2.0Seedance 2.0video16:9 · 9:16$0.55+
nano-banana-proNano Banana Proimage16:9 · 9:16$0.02
nano-banana-2Nano Banana 2image16:9 · 9:16$0.02
seedream-4.6Seedream 4.6image16:9 · 9:16$0.03
gpt-image-2GPT Image 2image16:9 · 9:16$0.05
// Ціни — живий приклад за генерацію (відео зі змінною тривалістю — «від»); повна матриця — GET /v1/pricing. Живі затримки — на сторінці стану.
ОСНОВНІ ПОНЯТТЯ

Як це працює

Асинхронність + опитування

Відправка одразу повертає id завдання. Опитуй GET /v1/jobs/{id} (з підтримкою ETag → 304 без змін). Вебхуки — незабаром.

Кредитний гаманець

Кожне завдання списується наперед у центах USD. У відповіді є cost_usd_cents для звірки.

Авто-повернення за збій

Якщо генерація не вдалась, кошти повертаються на баланс автоматично — платиш лише за отримані кліпи.

Поакаунтні ключі

Реєстрація відкрита — ключі видаються поакаунтно. Створи в боті командою /api_key_new; ротуй або відкликай будь-коли.

ЕНДПОЇНТИ

Довідка коротко

POST/v1/jobsВідправити завдання відео/зображення
GET/v1/jobs/{id}Статус завдання та URL результату
POST/v1/jobs/{id}/cancelСкасувати завдання
GET/v1/accountБаланс і дані API-ключа
GET/v1/pricingЖивий список моделей і цін

Готовий будувати?

Повна довідка ендпоїнтів, схеми та коди помилок — у документації API.

Отримати ключВідкрити повну довідку
RoyalTechno AI — API