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

Файлы

Референсы по ссылке, загрузка своих файлов и скачивание результатов.

Файлы по ссылке

Поля-списки ссылок (например image_urls) принимают прямые https-ссылки на файлы: сервер скачает их сам. Ссылка должна отдавать файл без входа, а не страницу просмотра. Какие поля есть у модели, сколько файлов и каких форматов, сказано на её странице.

JSON

{
  "prompt": "Make the background blue",
  "image_urls": [
    "https://example.com/reference.jpg"
  ]
}

Загрузить свой файл

Если публичной ссылки нет, загрузите файл в POST /v1/files (multipart/form-data, поле file) и передайте url из ответа в нужное поле настроек.

cURL

curl -X POST "https://api.cyhub.ai/v1/files" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@reference.jpg"

В ответе id, kind (image, audio, video), size, url и expires_at. Загруженный файл хранится 7 дней, ставьте задачу сразу после загрузки.

Вид	Форматы	Размер до
Картинка	jpg, jpeg, png, webp	30 МБ
Аудио	mp3, wav, ogg, m4a, flac, aac	20 МБ
Видео	mp4, mov, webm	200 МБ

Это общий потолок загрузки. У модели пределы могут быть строже, они на её странице и проверяются при постановке задачи.

Скачать результат

Файлы результата скачиваются по download_path из задачи с тем же ключом. Вместо 0 подставьте index нужного файла.

cURL

curl "https://api.cyhub.ai/v1/tasks/TASK_ID/artifacts/0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o result.png

Результаты хранятся 7 дней после завершения задачи. Потом files_expired становится true, download_path null, а история задачи остаётся. Сохраняйте файлы у себя.