Будуй з
RoyalTechno API
Ті самі керовані моделі, що й у боті — Veo 3.1, Seedance і Kling — як чистий REST API. Асинхронна відправка, опитування статусу, постійні URL у сховищі. Для батч-пайплайнів.
Перший кліп за три кроки
Авторизуйся, відправ завдання та забери готове відео, опитуючи статус.
- 1
Авторизація
Передай ключ як
Authorization: Bearer. Отримай його в боті командою/api_key_new. - 2
Відправ завдання
POST з
modelта блокомinput(prompt,aspect_ratio). У відповідь —idзавдання. - 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-fast", "input": { "prompt": "a cinematic drone shot over snowy mountains at sunrise", "aspect_ratio": "landscape", "duration_sec": 8 } }'
{ "id": "job_3Xk9aQ2", "object": "job", "model": "veo-3.1-fast", "status": "queued", "input": { "prompt": "a cinematic drone shot over snowy mountains at sunrise", "aspect_ratio": "landscape", "duration_sec": 8 }, "cost_usd_cents": 120, "created_at": "2026-06-01T09:41:00Z"}
# Poll until status is succeeded | failed (ETag-aware → 304 on no change)GET https://api.royaltechno.cc/v1/jobs/job_3Xk9aQ2{ "id": "job_3Xk9aQ2", "status": "succeeded", "output": { "type": "video", "url": "https://...r2.../job_3Xk9aQ2.mp4", "mime_type": "video/mp4", "duration_sec": 8 }, "cost_usd_cents": 120}
Доступні моделі
Передавай id у полі model. Повний живий список і ціни — GET /v1/pricing.
| ID моделі | Назва | Тип | Співвідношення | Тип. затримка |
|---|---|---|---|---|
veo-3.1-fast | Veo 3.1 Fast | video | 16:9 · 9:16 | ~40s |
seedance-2.0 | Seedance 2.0 | video | 16:9 · 9:16 | ~28s |
seedance-2.0-fast | Seedance 2.0 Fast | video | 16:9 · 9:16 | ~20s |
imagen-4 | Imagen 4 | image | 16:9 · 9:16 | ~9s |
nano-banana-2 | Nano Banana | image | 16:9 · 9:16 | ~9s |
seedream-4.6 | Seedream 4.6 | image | 16:9 · 9:16 | ~12s |
Як це працює
Асинхронність + опитування
Відправка одразу повертає id завдання. Опитуй GET /v1/jobs/{id} (з підтримкою ETag → 304 без змін). Вебхуки — незабаром.
Кредитний гаманець
Кожне завдання списується наперед у центах USD. У відповіді є cost_usd_cents для звірки.
Авто-повернення за збій
Якщо генерація не вдалась, кошти повертаються на баланс автоматично — платиш лише за отримані кліпи.
Ключі за запрошенням
У v1 ключі видаються поакаунтно. Створи в боті командою /api_key_new; ротуй або відкликай будь-коли.
Довідка коротко
Готовий будувати?
Повна довідка ендпоїнтів, схеми та коди помилок — у документації API.