Fellowi

Console API

Appelez le générateur Fellowi Images directement depuis votre code. Mêmes modèles, mêmes prix, même porte-monnaie de coins - juste une clé API à la place du formulaire web.

Authentification

Chaque requête nécessite une clé API dans l'en-tête Authorization: Bearer fk_live_.... Les clés se créent ci-dessous et ne sont affichées qu'une seule fois, à la création - conservez la vôtre en lieu sûr.

Votre clé API

Collez une clé : elle remplit chaque exemple de cette page et vous pouvez essayer l'API d'ici. Elle reste dans cet onglet du navigateur et n'est envoyée qu'à l'API de ce site.

Modèles

Choisissez un modèle avec le champ model. Les prix sont par image, en pièces Fellowi, et correspondent exactement à ce que facture l'Image Studio web. Une liste images vide donne du texte-vers-image ; avec des références, la requête passe sur le modèle d'édition, dont le tarif peut différer.

Sans model, vous obtenez fellowi-text-to-image - le même modèle et le même prix qu'a toujours eus une intégration écrite avant ce choix.

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

Créer une image

POST /v1/api/images renvoie immédiatement un 202 avec une génération en file d'attente ; l'image elle-même prend jusqu'à quelques minutes. Envoyez un en-tête Idempotency-Key pour qu'un nouvel essai ne paie jamais deux fois.

images est facultatif : jusqu'à 10 URL d'images publiques dont le modèle part (une photo de compagnon, votre propre référence). Chacune ajoute 10 pièces au prix, et une liste non vide bascule la génération sur le modèle d'édition au lieu du texte-vers-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": []
  }'

Options de la requête

Tout ce qui suit est facultatif. Chaque valeur par défaut reproduit le comportement de l'API avant l'existence de l'option, pour qu'une intégration ancienne continue de fonctionner sans changement.

quality
standard ou high. Détermine la résolution et le prix - voir le tableau ci-dessus.
format
png ou jpeg. Par défaut png.
aspectRatio
auto (par défaut) ou l'un de 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
Mettez enhancePrompt à true pour que votre prompt soit réécrit avant le rendu, pour 10 pièces de plus. enhanceStyle oriente cette réécriture : default, artistic, photographic, technical, anime ou realistic. Ignoré si enhancePrompt est désactivé.
images
Jusqu'à 10 URL d'images publiquement accessibles servant de point de départ. En envoyer une bascule la requête sur le modèle d'édition. Chaque image de référence dans images ajoute 10 pièces.

Interroger le résultat

Interrogez GET /v1/api/images/{id} jusqu'à ce que status vaille succeeded, puis téléchargez imageUrl. Les générations échouées sont remboursées automatiquement.

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

Quand une génération échoue

Une génération échouée rembourse ses pièces et renvoie l'un de quatre codes dans failureCode : TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR ou UNKNOWN. Rien de plus précis n'est publié - un code interne parlerait de notre pipeline plutôt que de votre requête.

Limites de débit et coût

Chaque clé a sa propre limite de requêtes par minute (visible dans le panneau ci-dessous) et peut porter un plafond de pièces quotidien. Ce sont des garde-fous anti-abus, pas la vraie limite - ce qui vous limite réellement, c'est votre solde de pièces Fellowi. 403 avec une page HTML : la requête a été arrêtée avant d'atteindre l'API, souvent à cause du User-Agent. Celui par défaut de Python-urllib est bloqué, envoyez le vôtre, par exemple User-Agent: my-app/1.0.