API-консоль

Вызывайте генератор Fellowi Images прямо из своего кода. Те же модели, те же цены, тот же кошелёк с монетами - просто вместо формы на сайте используется API-ключ.

Авторизация

Каждый запрос требует API-ключ в заголовке Authorization: Bearer fk_live_.... Ключ создаётся ниже и показывается только один раз, сразу после создания - сохраните его в надёжном месте.

Ваш API-ключ

API-ключ

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

Запомнить в этой вкладке

Модели

Выберите модель полем model. Цены указаны за изображение в монетах Fellowi и совпадают с ценами веб-версии Image Studio. Пустой список images означает text-to-image; если передать референсы, запрос уходит на модель редактирования, а она может стоить иначе.

Если не передать model, будет использована fellowi-text-to-image - та же модель и та же цена, что и всегда для интеграций, написанных до появления выбора.

curl https://fellowi.com/api/v1/api/models

Создать изображение

POST /v1/api/images сразу возвращает статус 202 с генерацией в очереди; само изображение готовится до нескольких минут. Передавайте заголовок Idempotency-Key, чтобы повтор запроса никогда не списал деньги дважды.

images - необязательное поле: до 10 публичных URL изображений, от которых отталкивается модель (фото компаньона, свой референс). Каждое добавляет 10 монет к цене; непустой список переключает генерацию на модель редактирования вместо text-to-image.

curl -X POST https://fellowi.com/api/v1/api/images \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "prompt": "a neon-lit cyberpunk portrait",
    "model": "fellowi-text-to-image",
    "quality": "standard",
    "format": "png",
    "aspectRatio": "1:1",
    "enhancePrompt": false,
    "enhanceStyle": "default",
    "images": []
  }'

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

Все параметры ниже необязательны. Каждое значение по умолчанию повторяет поведение API до появления этого параметра, поэтому старая интеграция продолжает работать без изменений.

quality: standard или high. Задаёт разрешение и цену - см. таблицу выше.
format: png или jpeg. По умолчанию png.
aspectRatio: auto (по умолчанию) либо одно из 1:1, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21.
enhancePrompt / enhanceStyle: Поставьте enhancePrompt в true, чтобы промпт переписали перед генерацией, за 10 монет сверху. enhanceStyle задаёт направление этой переработки: default, artistic, photographic, technical, anime или realistic. При выключенном enhancePrompt поле игнорируется.
images: До 10 публично доступных URL изображений, от которых отталкивается модель. Любое из них переключает запрос на модель редактирования. Каждое референс-изображение в images добавляет 10 монет сверху.

Опрашивать результат

Опрашивайте GET /v1/api/images/{id}, пока статус не станет succeeded, затем скачайте imageUrl. Неудачные генерации возвращаются монетами автоматически.

curl https://fellowi.com/api/v1/api/images/{id} \
  -H "Authorization: Bearer fk_live_..."

Если генерация не удалась

При неудаче монеты возвращаются, а в поле failureCode приходит один из четырёх кодов: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR или UNKNOWN. Ничего более подробного мы не публикуем - внутренний код рассказал бы о нашем конвейере, а не о вашем запросе.

Лимиты и стоимость

У каждого ключа есть свой лимит запросов в минуту (виден в панели ниже) и может быть дневной лимит по монетам. Это защита от злоупотреблений, а не реальный предел - фактически вас ограничивает только баланс монет Fellowi. 403 с HTML-страницей: запрос остановлен до API, обычно из-за User-Agent. Стандартный Python-urllib блокируется, укажите свой, например User-Agent: my-app/1.0.