Перейти к основному контенту

Интеграции

Подключайте модели изображений, видео и отдельные языковые модели через единый API.

Для чата и ролевых диалогов используйте OpenAI-совместимые вызовы, для изображений, видео и аудио — API задач. Выберите модель, храните ключ на сервере и перейдите к подходящему способу получения результата.

Выберите способ

Один API-ключ, четыре способа подключения

Начните там, где вы уже работаете. Любым способом вы получаете те же модели по тем же ценам.

Быстрый старт за 5 минут

Первое изображение за четыре шага

Создайте задачу, сохраните её ID и заберите готовый файл. Та же схема работает для любой модели изображений, видео и аудио.

  1. 01

    Выбрать модель

    Сравнить задачу, входные данные, политику, текущую доступность и цену.

  2. 02

    Скопировать запрос

    Замените ID модели и input из примера на точные поля со страницы этой модели. Не угадывайте параметры по другой модели.

  3. 03

    Отправить с сервера

    HTTP 202 означает, что задача принята, а не что генерация завершена; бизнес-код в конверте ответа по-прежнему code: 200. Сразу сохраните data.taskId; estimatedCost — сумма, зарезервированная под эту задачу.

  4. 04

    Опрашивать статус ограниченным числом попыток

    queued и running ещё выполняются; succeeded, failed и expired — конечные состояния. Останавливайте опрос на любом конечном состоянии, а не ждите только успеха.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image — реальный эндпоинт генерации изображения из текста. Для другой медиамодели используйте её точный ID и схему.

Каталог

Все интеграции в одном месте

Выберите инструмент, которым вы уже пользуетесь. Каждая карточка ведёт к руководству по настройке.

Безопасность сервера

Три обязательных условия для рабочей среды

Эти три правила закрывают утечку ключа, двойное списание и потерю задачи. Это минимум перед запуском.

Храните API-ключ на сервере

Не раскрывайте ключ в браузере, мобильной сборке, промпте, журнале или ответе агента. Отправляйте запросы из бэкенда под своим контролем.

Idempotency-Key

На каждое создание задачи отправляйте стабильный Idempotency-Key. Если результат сети неясен, повторяйте ту же работу с тем же ключом, чтобы не появилось двух оплачиваемых задач.

Отслеживайте принятые медиазадачи

Сохраните taskId и используйте подписанный webhook или ограниченные проверки статуса. Принятая задача запускается и не может быть отменена. Неудачные задачи и задачи с истёкшим сроком обычно не оплачиваются. Некоторые модели взимают плату за отказ по содержанию, как указано на странице модели; проверьте эти условия до отправки.

Документация API

Перейти в подробную документацию по своему вопросу