Пример запроса
curl https://api.velourapi.ru/v1/images/generations \
-H "Authorization: Bearer $VELOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"prompt": "Бордовый бархат в мягком контровом свете, крупный план",
"size": "1536x1024",
"resolution": "2K"
}'В ответе придёт ссылка на изображение. Для изменения готовой картинки передайте её адрес в поле image: многие модели принимают референс.
Основные параметры
size— размер или формат кадра: по нему определяется соотношение сторон;resolution— 1K, 2K, 4K у моделей, которые это поддерживают;quality— low, medium, high у моделей GPT Image;image— ссылка на референс для правки или стиля.
Модели и цены
| Модель | Варианты | Референс | Цена* |
|---|---|---|---|
| GPT Image 2.5 Flare | low, medium, high | да | $0.016–$0.064 |
| GPT Image 2.5 Sunburst | low, medium, high | да | $0.016–$0.064 |
| GPT Image 2.5 | — | да | $0.019 |
| Nano Banana 2 | 1K, 2K, 4K | да | $0.096–$0.19 |
| Nano Banana Pro | 1K, 2K, 4K | да | $0.17–$0.29 |
| Nano Banana | — | да | $0.048 |
| Seedream 5 Lite | 2K, 3K | да | $0.083 |
| Seedream 5 Pro | 1K, 2K | да | $0.11–$0.22 |
| Qwen Image | — | нет | $0.024 |
| Z-Image | — | нет | $0.006 |
| GPT Image 2 | 1K, 2K, low, medium, high | да | $0.014–$1.01 |
| Mango 3 Turbo | 1K, 2K | да | $0.043 |
| Mango 3 | 1K, 2K | да | $0.11–$0.22 |
| Mango 3S | 2K, 3K | да | $0.088 |
* Цены ориентировочные: рассчитаны по таблице стоимости с нашей наценкой. Точную сумму вы видите в каталоге моделей и в подборе по задаче до запуска.
Как получить хороший результат
- Описывайте композицию: что в кадре, откуда смотрит камера, какой свет;
- Надписи в кадре лучше делать моделями, которые хорошо рисуют текст;
- Для макетов и обложек используйте высокое разрешение, для черновиков — минимальное;
- Нужно несколько вариантов — отправьте несколько запросов: каждая картинка считается отдельно.
Частые вопросы
Сколько стоит одна картинка?
Зависит от модели и разрешения: от долей цента у быстрых моделей до нескольких центов у флагманов. Точная цена видна в каталоге.