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

Справочник REST API и MCP-сервера для зарегистрированных пользователей.

API

Создайте ключ в разделе «Подключения», отправьте задание, прочитайте статус, скачайте результат.

Описание OpenAPI (YAML)

API-ключи →

MCP

Добавьте сервер Orisigil в MCP-клиент и авторизуйте его своим аккаунтом.

Адрес MCP-сервера: https://orisigil.com/mcp

MCP-приложения →

Аутентификация

Передавайте API-ключ в заголовке Authorization: Bearer <key>. Ключи создаются в разделе «Подключения». У ключа есть разрешения sign, read и download.

Подпись файла в три запроса

# 1. Upload one file (multipart field "file")
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" \
  -F file=@image.jpg https://orisigil.com/api/v1/assets

# 2. Create a batch of signing jobs (202 Accepted)
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" \
  -H "Idempotency-Key: 7d1c3f62-run-42" -H "Content-Type: application/json" \
  -d '{"asset_ids":["<asset id>"],"options":{"creation_method":"ai_generated","tool":"Model X"}}' \
  https://orisigil.com/api/v1/signing-batches

# 3. Read the job; download the result when it is completed
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" https://orisigil.com/api/v1/signing-jobs/<job id>
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" -o signed.jpg \
  https://orisigil.com/api/v1/signing-jobs/<job id>/result

Ошибки

У ошибок есть стабильный error_code. Файл больше лимита даёт 413 file_too_large с max_size_bytes. Повтор Idempotency-Key с другим запросом даёт 409 idempotency_conflict.