Байты файла по подписанной ссылке

GEThttps://api.souz.ai/v1/files/{id}/{filename}

Ссылка из url файла; ключ не нужен — подпись и есть авторизация. Работают HEAD, Range, If-None-Match; ?download=1 отдаёт как вложение. Хост — media.souz.ai, CORS *: файл можно встраивать на любые страницы.

Параметры пути

idstringобязательно

Id файла.

Шаблон: ^file_

Пример: "file_9f8e7d6c5b4a"

filenamestringобязательно

Параметры запроса

expinteger · int64обязательно

До какого момента (unix-секунды) действует ссылка.

sigstringобязательно

Подпись ссылки.

downloadstring

1 — отдать как вложение (Content-Disposition: attachment).

Значения: 1

Заголовки

Rangestring

Часть файла, bytes=начало-конец — ответ 206.

Ответы

200Байты файла; тип — тот, что в `content_type` файла.

application/json

application/octet-stream

audio/mpeg

audio/wav

image/jpeg

image/png

image/webp

video/mp4

video/quicktime

206Запрошенный `Range`.

application/json

application/octet-stream

audio/mpeg

audio/wav

image/jpeg

image/png

image/webp

video/mp4

video/quicktime

304Не изменилось с прошлого раза: `If-None-Match` совпал с `ETag`.

400Запрос отклонён; `error.detail[]` называет поля и допустимые значения.

application/json

Error

403Нельзя: у ключа не тот вид (модели запускает API-ключ, аккаунт — ключ управления), у роли

Нельзя: у ключа не тот вид (модели запускает API-ключ, аккаунт — ключ управления), у роли участника нет права или подпись ссылки на файл не сходится. detail[].reason говорит, что именно: requires_api_key, requires_management_key, cabinet_only (только в кабинете), insufficient_role (в allowed — роли, которым можно), not_key_author (секрет ключа открывает только тот, кто его создал).

application/json

Error

404Нет такого объекта у этого аккаунта.

application/json

Error

410Срок жизни файла вышел, байты удалены.

application/json

Error

Запрос

curl -X GET 'https://api.souz.ai/v1/files/{id}/{filename}?exp=<exp>&sig=<sig>'

import requests

response = requests.get(
    "https://api.souz.ai/v1/files/{id}/{filename}?exp=<exp>&sig=<sig>",
)
print(response.json())

const response = await fetch("https://api.souz.ai/v1/files/{id}/{filename}?exp=<exp>&sig=<sig>", {
  method: "GET",
});
console.log(await response.json());

Ответ

{
  "error": {
    "code": "capability_mismatch",
    "detail": [
      {
        "allowed": [
          "1:1",
          "16:9",
          "9:16"
        ],
        "path": "aspect_ratio",
        "reason": "unsupported_value"
      }
    ],
    "message": "the model does not support this value",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "forbidden",
    "detail": [
      {
        "reason": "requires_api_key"
      }
    ],
    "message": "this endpoint takes an API key; a management key manages the account only",
    "type": "permission_error"
  }
}