APIコンソール

Fellowi Imagesの生成エンジンを自分のコードから直接呼び出せます。モデルも価格もコインウォレットも同じで、Webフォームの代わりにAPIキーを使うだけです。

認証

すべてのリクエストにはAuthorizationヘッダーでAPIキーが必要です: Authorization: Bearer fk_live_.... キーは下で作成でき、作成直後の一度だけ表示されます。安全な場所に保管してください。

あなたのAPIキー

APIキー

キーを貼り付けると、このページのすべての例に入り、ここからAPIを試せます。キーはこのブラウザのタブにだけ残り、このサイトのAPIにだけ送られます。

このタブで記憶する

モデル

model フィールドでモデルを選びます。価格は画像1枚あたりの Fellowi コインで、Web の 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 は任意です。モデルが下敷きにする公開画像 URL を最大10件まで指定できます (コンパニオンの写真、自分の参照画像など)。1件ごとに 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": []
  }'

リクエストのオプション

以下はすべて任意です。各既定値はそのオプションが存在しなかった頃の挙動と同じなので、古い連携はそのまま動き続けます。

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 が false のときは無視されます。
images: 下敷きにする公開画像 URL を最大10件。1件でも送るとリクエストは編集モデルに切り替わります。 images の参照画像は1件につき 10 コインが加算されます。

結果をポーリングする

status が succeeded になるまで GET /v1/api/images/{id} をポーリングし、imageUrl をダウンロードしてください。失敗した生成は自動的に返金されます。

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

生成が失敗したとき

失敗した生成はコインが返金され、failureCode に4種類のいずれかが入ります: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR, UNKNOWN。これ以上細かい情報は公開していません - 内部コードはあなたのリクエストではなく、私たちのパイプラインの話になってしまうからです。

レート制限と費用

キーごとに1分あたりのリクエスト数の上限があり (下のパネルで確認できます)、1日のコイン上限を設定することもできます。これらは不正利用対策であって本当の上限ではありません - 実際に生成できる枚数を決めるのは Fellowi コインの残高です。 HTML ページ付きの 403: リクエストは API に届く前に止められました。多くは User-Agent が原因です。Python-urllib の既定値はブロックされるため、独自の値 (例: User-Agent: my-app/1.0) を送ってください。