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.