GPT-Image 2.6 Flare и Sunburst уже доступныОт $0.025 за изображение
OmniaKey
Войти

Настройка ключа API

Ключ API Seedance: получить, настроить, проверить

Перед настройкой ключа API Seedance выберите, кто его выдаёт. Ключ, URL API и ID модели должны соответствовать друг другу. Следующие шаги настраивают доступ через OmniaKey.

Официальный ключ поставщика

Чтобы получить ключ, который выдаёт ByteDance и по которому выставляет счета, следуйте инструкциям поставщика по аккаунту и ключу API.

Открыть официальную инструкцию для ключа

Ключ API OmniaKey

Используйте один баланс и один ключ OmniaKey для моделей, доступных вашему аккаунту. Ключ работает с эндпоинтом OmniaKey.

Получить ключ API

01Создайте ключ API OmniaKey

Войдите, откройте раздел «Ключи API» и создайте ключ для приложения. Проверьте квоту, срок действия и ограничения по моделям. Пополните баланс перед запуском запросов на генерацию.

Получить ключ API

02Задайте ключ и URL API

Выполните команды в своём терминале и замените заполнитель своим ключом. Храните ключ на сервере или в менеджере секретов. Никогда не помещайте его в код браузера или публичный репозиторий.

bash / zsh
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Проверьте аутентификацию

Запросите список моделей, не запуская задачу генерации. Успешный ответ — это JSON с массивом data. Так проверяется доступ по ключу; это не гарантирует, что все модели включены для вашего аккаунта.

GET /v1/models
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Используйте формат запроса модели

Выберите модель на странице семейства, скопируйте её ID API и следуйте соответствующей документации. Одна аутентификация не проверяет параметры генерации.

Генерация изображений и видео использует POST /v1/media/tasks. Сохраняйте тот же Idempotency-Key при повторной отправке того же запроса, сохраните полученный ID задачи и опрашивайте GET /v1/media/tasks/{id} для получения результата.

Пример запроса на генерацию (платный)

Этот запрос использует баланс вашего аккаунта. Сначала проверьте цену выбранной модели. Пример следует документированному формату запроса; доступ к модели всё равно должен быть у вашего аккаунта.

POST /v1/media/tasks
curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-first-request-001" \
  -d '{
  "model": "dreamina-seedance-2-5-260628",
  "type": "video",
  "operation": "text_to_video",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "duration": 5,
    "resolution": "720P",
    "ratio": "16:9"
  }
}'

Опрос задачи с медиа

Замените YOUR_TASK_ID на id, возвращённый запросом создания. Опрашивайте до перехода задачи в финальный статус. Для успешной задачи скачайте URL из assets до истечения срока. Новый ключ идемпотентности используйте только для новой задачи.

GET /v1/media/tasks/{id}
curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"
Читать документацию API

Если подключение не удалось

  • 401: проверьте, что ключ полный, активный и выпущен для URL API, к которому вы обращаетесь.
  • 403: проверьте ограничения ключа по моделям и разрешения, доступные вашему аккаунту.
  • 404 или HTML вместо JSON: проверьте хост API и префикс версии. Используйте api.omniakey.com, а не адрес сайта.
  • 429: снизьте параллелизм и следуйте рекомендациям по повтору из ответа. Не отправляйте задачи генерации снова с новыми ключами идемпотентности.