Процес подачі заявки
Щоб використовувати Grok Videos Generation API, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігайте його для подальшого використання.
Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку.
Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно протестувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.
📘 Повна документація: Grok Videos Generation API →
Опис моделей
За допомогоюmodel можна вибрати одну з наступних чотирьох публічних моделей. Їхні можливості та способи тарифікації наведено нижче:
grok-imagine-video-1.5-fast:reverse(за замовчуванням): підтримує генерацію відео з тексту (передається лишеprompt) і генерацію відео із зображення (передаєтьсяimage_url), тривалість 6–30 секунд, тарифікація за тривалістю за рівнями; найдешевший варіант.grok-imagine-video:reverse: підтримує генерацію відео з тексту та зображення, тривалість 1–15 секунд, тарифікація за секундами результату.grok-imagine-video:official: підтримує генерацію відео з тексту та зображення, тривалість 1–15 секунд, тарифікація за секундами результату, вища якість зображення.grok-imagine-video-1.5:official: підтримує лише генерацію відео із зображення, обов’язково потрібно передатиimage_url, тривалість 1–15 секунд, підтримує до1080p, тарифікація за секундами результату.
Основне використання
Спочатку ознайомтеся з основним способом використання, введіть підказкуprompt, модель model та інші параметри, щоб згенерувати відповідне відео.
Ми налаштували заголовки запиту, включаючи:
accept: формат відповіді, який ви хочете отримати, тут вказаноapplication/json, тобто формат JSON.authorization: ключ для виклику API, після подачі заявки ви можете вибрати його зі списку.
prompt: текстова підказка, що описує вміст відео, яке потрібно згенерувати. Обов’язково для відео, згенерованого з тексту; необов’язково при передачіimage_url.model: модель для генерації відео, можна вибратиgrok-imagine-video-1.5-fast:reverse(за замовчуванням),grok-imagine-video:reverse,grok-imagine-video:officialабоgrok-imagine-video-1.5:official.image_url: посилання на вхідне зображення для відео, згенерованого з зображення. Обов’язково, колиmodelєgrok-imagine-video-1.5:official.reference_image_urls: масив необов’язкових посилань на референсні зображення, які використовуються для направлення стилю або вмісту відео.aspect_ratio: співвідношення сторін для згенерованого відео, можна вибрати1:1/16:9/9:16/4:3/3:4/3:2/2:3.resolution: вихідна роздільна здатність, можна вибрати480p(за замовчуванням),720pабо1080p.duration: тривалість згенерованого відео (секунди).grok-imagine-video-1.5-fast:reverseмає діапазон 6–30, інші моделі - 1–15, за замовчуванням 6. Рекомендується використовувати 6 секунд або 10 секунд, ці два стандартні часи є відносно стабільними.callback_url: адреса асинхронного зворотного виклику, після налаштування API негайно повернеtask_id, а після завершення завдання результат буде надіслано на цю адресу.async: необов’язково, якщо встановити вtrue, інтерфейс негайно повернеtask_id, не потрібно надаватиcallback_url, потім через відповідний інтерфейс запиту завдань можна опитувати для отримання результатів.
success: чи була успішною запит на генерацію відео.task_id: ID завдання на генерацію відео.trace_id: ID відстеження запиту, використовується для усунення неполадок.data: список результатів згенерованого відео.id: унікальний ідентифікатор згенерованого відео.video_url: адреса посилання на згенероване відео.state: стан завдання на генерацію відео, можливі значенняpending/succeeded/failed.
video_url з результату data.
Відповідний код CURL виглядає так:
Відео, згенероване з зображення
Якщо ви хочете згенерувати відео на основі вхідного зображення, ви можете передатиimage_url. При використанні grok-imagine-video-1.5:official це поле обов’язкове:
Направлення за допомогою референсних зображень
Якщо ви хочете використовувати одне або кілька референсних зображень для направлення стилю або вмісту відео, ви можете передати масив посилань на зображення вreference_image_urls:
Асинхронний зворотний виклик
Відео генерація потребує певного часу обробки. Якщо ви не хочете підтримувати довге з’єднання в очікуванні, ви можете передатиcallback_url, у цьому випадку API негайно поверне task_id, а після завершення завдання надішле остаточний результат на цю адресу:
Запит результатів завдання
Якщо ви використовували асинхронний зворотний виклик або хочете активно перевірити статус завдання, ви можете через Grok Tasks API (POST https://api.acedata.cloud/grok/tasks) за task_id перевірити останній статус та результати завдання.
Опис тарифікації
Спосіб тарифікації цієї послуги визначається параметромmodel:
grok-imagine-video-1.5-fast:reverse: тарифікація за тривалістю за рівнями, незалежно від роздільної здатності — для6–10секунд,11–20секунд і21–30секунд діють різні цінові рівні.grok-imagine-video:reverse: тарифікація за «секундами результату», загальна вартість = ціна за одиницю ×duration.grok-imagine-video:officialіgrok-imagine-video-1.5:official: тарифікація за «секундами результату»; що вища роздільна здатність, то вища ціна за одиницю. За офіційні моделі стягується плата навіть у разі невдалого проходження модерації вмісту.
Обробка помилок
Коли запит має проблеми, API поверне відповідний код помилки та опис, найбільш поширені з них:400: параметри запиту некоректні, наприклад, у відео без тексту відсутнійprompt, абоgrok-imagine-video-1.5:officialбезimage_url, абоdurationвиходить за межі (дляgrok-imagine-video-1.5-fast:reverse6–30, для інших моделей 1–15).401: невдала аутентифікація, токен недійсний або не відповідає API.403: недостатньо коштів, або підказка потрапила під перевірку контенту і була відхилена.429: запити занадто часті, будь ласка, спробуйте пізніше.500: невдала генерація відео або аномалія в сервісі.

