Содержание
Как подключить API D-ID: первый запрос
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 18 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Как подключить API D-ID: первый запрос строится вокруг одного действия — получить ключ в студии и отправить его в заголовке Authorization вместе с вызовом нужного эндпоинта. Ключ выдаётся в формате API_USERNAME:API_PASSWORD и показывается один раз. Дальше вы выбираете путь: агенты в реальном времени или генерация видео. Ниже — порядок действий, примеры и проверка результата. Мы скачали подборку результатов веб-поиска по запросу «Как подключить API D-ID: первый запрос»: текст отдали 10 из 10.
Что даёт API D-ID и где проходят границы продукта
В документации проекта D-ID описаны два направления работы. Первое — интерактивные агенты, которые ведут диалог в реальном времени: цифровые аватары соединяются с языковыми моделями и базами знаний, а поток идёт через WebRTC. Второе — асинхронная генерация видео из изображений, текста и аудио: говорящие аватары, перевод роликов на другие языки, цифровые ведущие.
Набор возможностей агентской части в документации перечислен так: создание агентов с собственными аватарами и инструкциями для модели, сессии с потоковым видео через SDK, базы знаний на основе RAG с загрузкой документов, выбор модели и провайдера, экспорт истории чатов в структурированный JSON, встраивание агентов на сайт через готовый интерфейс и клиентские ключи.
Видео-часть включает несколько типов аватаров. V4 Expressive Avatars дают выразительные ролики с разными эмоциональными состояниями. V3 Pro Avatars — Full-HD видео с премиальными ведущими и естественными движениями тела. V3 Instant Avatars создают собственный аватар из короткой видеозаписи. V2 Photo Avatars превращают фотографию и текст в говорящую голову. Video Translate переводит ролики с автоматической синхронизацией губ и клонированием голоса.
Граница продукта проходит по способу работы. В интервью на сайте D-ID технический специалист Саймон Кураку объясняет: API выбирают для автоматизации, масштабирования и глубокой интеграции, а студия подходит для ручного создания контента без кода. Кредиты, потраченные через API, списываются с того же баланса, что и в студии.
Для первого запроса это означает простую вещь: вам нужен аккаунт с положительным балансом и ключ. Без действующих кредитов вызовы не пройдут.
Условия доступа: ключ, баланс и где смотреть требования
Ключ берётся в студии. В документации проекта указан маршрут из четырёх шагов: войти в студию, открыть настройки аккаунта, нажать Generate API key и сохранить значение в надёжном месте. Ключ имеет формат API_USERNAME:API_PASSWORD и виден только один раз при генерации.
В разделе с частыми вопросами на сайте D-ID сказано, что для использования API обязательно иметь действующие кредиты на аккаунте. Там же уточняется, что кредиты для API берутся из того же баланса, что и студия. Документация по ключам повторяет: ключ из студии используется для аутентификации всех запросов к API.
Актуальные требования стоит сверять на Developer Hub — так в ответах на частые вопросы назван раздел с документацией. Там же лежит страница для старта с обзором продукта, свежими обновлениями и видеоуроками по возможностям API. Индекс документации для машин доступен по адресу https://docs.d-id.com/llms.txt, а к любой странице документации можно добавить .md, чтобы получить markdown-версию.
Авторизация устроена через HTTP-заголовок Authorization. В документации по базовой аутентификации сказано: если не передать учётные данные, превысить лимит запросов или квоту, система вернёт сообщение об ошибке. Заголовок собирается как Basic API_USERNAME:API_PASSWORD.
Таблица ниже сводит элементы доступа.
| Элемент | Где взять | Формат |
|---|---|---|
| API-ключ | Настройки аккаунта в студии | API_USERNAME:API_PASSWORD |
| Заголовок запроса | Формируется вручную | Authorization: Basic <ключ> |
| Кредиты | Баланс аккаунта | Общий со студией |
| Документация | Developer Hub | docs.d-id.com |
Ключ показывается один раз, поэтому сохраните его сразу. Потерянное значение придётся генерировать заново.
Порядок действий: от ключа до первого ответа
Первый запрос удобно строить на создании агента — этот путь подробно описан в документации по встраиванию. Порядок такой: получить ключ, отправить запрос на создание агента, сохранить идентификатор из ответа, сгенерировать клиентский ключ, вставить скрипт на страницу.
Запрос на создание агента идёт методом POST на адрес https://api.d-id.com/agents. В теле передаются имя превью, тип презентера, идентификатор презентера и голос. Документация приводит пример с презентером типа clip, идентификатором v2_public_Amber@0zSz8kflCN и голосом microsoft с идентификатором en-US-JennyMultilingualV2Neural.
После ответа нужно сохранить поле id — оно понадобится для встраивания. Затем генерируется клиентский ключ: POST на https://api.d-id.com/agents/client-key с телом, где перечислены разрешённые домены, например http://localhost:3000 и https://yourdomain.com. Из ответа сохраняется поле client_key.
Финальный шаг — скрипт на странице. Документация даёт тег с модулем https://agent.d-id.com/v2/index.js, атрибутами режима, клиентского ключа, идентификатора агента и имени. Плейсхолдеры {client_key} и {agent_id} заменяются на ваши значения. Тот же скрипт можно получить в студии: навести курсор на агента, открыть меню и выбрать Embed.
Для диалога с агентом есть отдельный эндпоинт https://api.d-id.com/agents/{agentId}/chat методом POST. Каждый чат хранит отдельную историю, а параметр сохранения позволяет оставить чат и не удалять его автоматически.
Если задача — видео, логика та же: ключ в заголовке, POST на нужный эндпоинт, разбор ответа. Асинхронная генерация возвращает результат отдельно от запроса.
Учебный пример и критерии проверки
Соберём упражнение, которое проверяет всю цепочку. Возьмите ключ из студии и отправьте запрос на создание агента с параметрами из документации. Задача — получить ответ с идентификатором и убедиться, что авторизация прошла.
Критерии проверки формулируются так. Первое: ответ пришёл без ошибки авторизации. Второе: в теле ответа есть поле id, и вы его сохранили. Третье: запрос на клиентский ключ с вашими доменами вернул поле client_key. Четвёртое: скрипт на тестовой странице загрузился с подставленными значениями.
Проверять удобно в два прохода. Сначала — только авторизация: минимальный запрос, где важно увидеть, что заголовок принят. Потом — полный сценарий с агентом и встраиванием. Так вы отделяете проблему ключа от проблемы параметров.
Для отладки полезна вкладка с примерами в документации: рядом с каждым эндпоинтом есть поле Authorization, куда можно вставить ключ, разделив его на имя пользователя и пароль, и запустить пример. Это даёт эталонный ответ, с которым сравнивается ваш.
Отдельно проверьте баланс. Если кредитов нет, запросы не пройдут независимо от корректности ключа. Кредиты списываются с общего баланса, поэтому пополнение делается там же, где и для студии.
Смежные варианты: агенты, видео, встраивание
Выбор варианта диктуется задачей. Агенты подходят для интерактивных сценариев: клиентская поддержка, консультации, диалог с базой знаний. Сессии агента идут через клиентский SDK, который берёт на себя WebRTC и даёт простой интерфейс для чата. Установка SDK описана командой npm install @d-id/client-sdk.
Видео подходит для заранее подготовленного контента: презентации, обучающие ролики, переводы. Здесь доступны разные типы аватаров — от фото до Full-HD ведущих с движениями тела. Асинхронная модель означает, что результат приходит не мгновенно.
Встраивание на сайт — отдельный сценарий. Документация обещает добавить агента за пять минут одним тегом скрипта, без бэкенда: нужны только тег и клиентский ключ. Клиентский ключ работает лишь с тех доменов, которые вы указали при генерации.
Таблица помогает сопоставить варианты.
| Задача | Вариант | Что нужно |
|---|---|---|
| Диалог в реальном времени | Агент + сессия | Ключ, клиентский ключ, SDK |
| Готовый ролик | Видео-эндпоинт | Ключ, параметры аватара |
| Агент на сайте | Встраивание | Ключ, клиентский ключ, домены |
Для голосов доступны премиальные варианты ElevenLabs: в интервью на сайте D-ID сказано, что все высококачественные голоса Pro+ в студии — это голоса ElevenLabs, и они доступны из API для Talks, Clips и Streaming. Собственный ключ ElevenLabs можно передать для синтеза речи с клонированными голосами.
Типичные проблемы и способы диагностики
Первая проблема — ошибка авторизации. Документация по чату упоминает ответ 401 AuthorizationError. Причина обычно в формате заголовка: ключ должен идти как Basic API_USERNAME:API_PASSWORD, целиком, без разрыва на части. Проверьте, что значение скопировано полностью и не содержит лишних пробелов.
Вторая — превышение лимитов. Документация по аутентификации прямо говорит: при пропуске учётных данных, превышении лимита запросов или квоты система отвечает ошибкой. Диагностика простая: сверьте частоту вызовов и остаток кредитов.
Третья — клиентский ключ не работает на домене. Ключ действует только с разрешённых доменов, указанных при генерации. Если тест идёт с localhost, добавьте его в список вместе с рабочим доменом.
Четвёртая — потерянный ключ. Значение показывается один раз, восстановить его нельзя. Решение — сгенерировать новый в настройках аккаунта.
Пятая — пустой ответ при верном ключе. Проверьте метод и адрес эндпоинта, а также заголовок типа содержимого. Для запросов с телом документация указывает Content-Type: application/json.
Диагностику удобно вести по шагам: сначала авторизация, потом параметры, потом домены. Каждый шаг проверяется отдельным запросом.
Частые вопросы
Как получить ключ для API D-ID?
Ключ генерируется в студии: войдите в аккаунт, откройте настройки, нажмите Generate API key. Значение в формате API_USERNAME:API_PASSWORD показывается один раз, поэтому сохраните его сразу в надёжном месте. Этот ключ используется для аутентификации всех запросов к API.
Нужны ли кредиты для работы с API?
Да, по данным раздела с частыми вопросами на сайте D-ID, для использования API обязательно иметь действующие кредиты на аккаунте. Кредиты для API списываются с того же баланса, что и в студии. Без положительного баланса запросы не пройдут.
Как отправить первый запрос?
Соберите POST-запрос на нужный эндпоинт, например на https://api.d-id.com/agents для создания агента. В заголовке Authorization передайте Basic и ваш ключ, в заголовке типа содержимого укажите application/json. В теле разместите параметры презентера и голоса.
Что делать при ошибке авторизации?
Ответ 401 AuthorizationError указывает на проблему с ключом. Проверьте, что заголовок собран как Basic API_USERNAME:API_PASSWORD и значение скопировано полностью. Документация отмечает, что ошибка приходит и при превышении лимита запросов или квоты.
Где смотреть актуальные требования?
Актуальные требования собраны на Developer Hub — так раздел с документацией назван в ответах на частые вопросы. Там есть страница для старта с обзором продукта, обновлениями и видеоуроками. К любой странице документации можно добавить .md для получения markdown-версии.
Если вы работаете с видеоаватарами, полезно сравнить подходы разных сервисов — например, HeyGen в России: доступ, оплата и работа разбирает доступность и оплату. Для голосовой части пригодится материал Covers AI бесплатно: как сделать кавер голосом нейросети. А при отладке окружения может выручить разбор Не запускается эмулятор в Android Studio: причины и решение.