Skip to Content
ГенерацияФайлы

Загрузка файлов

Многие модели принимают image_url, video_url или audio_url как часть input. Например, image-to-image или voice-cloning. Передавайте публичный HTTPS-URL — всё, что доступно по https://, подходит.

Свой публичный URL

Самый прямой путь: положите файл на ваш CDN или S3 (с публичным доступом или signed URL) и используйте этот URL в запросе:

curl -X POST https://api.neuroartist.ru/run/flux/dev/image-to-image \
  -H "Authorization: Bearer na_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "make it watercolor",
    "image_url": "https://your-cdn.example.com/photo.jpg",
    "strength": 0.65
  }'

Условия для URL:

  • HTTPS, доступ без авторизации (либо signed URL).
  • CORS не нужен (наш бэкенд скачает по серверному запросу).
  • Должен оставаться доступным до конца генерации — иначе provider_error.

Загрузка через дашборд

Если своего хостинга нет, в дашборде gateway.neuroartist.ru → Файлы → Загрузить можно положить файл в наш S3 и получить публичный https://s3.cloud.ru/... URL — его и передавайте в image_url.

ПараметрЗначение
Max size10 MiB
Imageimage/jpeg image/png image/webp image/heic image/heif
Videovideo/mp4 video/quicktime video/webm
Audioaudio/mpeg audio/wav audio/webm audio/mp4 audio/ogg audio/flac

Когда нужен URL, а когда нет

Schema полеДействие
image_url, video_url, audio_url, *_urlПередавайте URL
prompt, negative_prompt (string)Просто текст
image (base64, редкий случай)base64 inline в JSON

Чтобы узнать какие поля принимает конкретная модель — GET /models/{modelId} отдаёт JSON Schema input-а.

Дальше

  • Image-to-image — использовать image_url в генерации.
  • Image-to-video — стартовый кадр для видео.
WebhooksБиллинг