Обзор

REST API SciDraw AI предоставляет стабильные эндпоинты на основе задач для генерации изображений, их редактирования и конвертации форматов.

Базовый URL: https://sci-draw.com

Машиночитаемая спецификация: OpenAPI JSON · OpenAPI YAML

Оба файла описывают одно и то же API в формате OpenAPI. Импортируйте любой из них в Postman или Insomnia — и все эндпоинты с параметрами будут заполнены заранее; передайте генератору кода — получите типизированный клиент; отдайте ИИ-агенту — и он сможет вызвать API, не заставляя вас писать запрос вручную. Форматы равнозначны, выбирайте тот, который принимает ваш инструмент.

Быстрый старт

1. Создайте ключ API в разделе Настройки → Ключи API и выберите только те права, которые нужны вашей интеграции.
2. Передавайте ключ как Authorization: Bearer sd_....
3. Добавляйте уникальный Idempotency-Key к каждому запросу на создание.
4. Сохраняйте возвращённый идентификатор задачи и опрашивайте её адрес из Location, пока она не перейдёт в succeeded, failed или canceled.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

Запрос на создание обычно возвращает 202 Accepted, объект задачи, заголовок Location и Retry-After: 2. Можно добавить Prefer: wait=10 и подождать до десяти секунд. Ожидание никогда не меняет семантику задачи: статус 200 приходит, только если задача уже завершена, иначе остаётся 202.

Эндпоинты

Все ответы — это JSON-обёртки. В каждом ответе есть X-Request-Id; указывайте этот идентификатор при обращении в поддержку. Единственные ссылки на файлы в ответах — это URL результата и публичные идентификаторы файлов. Маршрутизацией возможностей управляет SciDraw AI.