画像APIがコイン課金である理由（そして失敗時に自動返金される理由）

Fellowi Imagesの上に公開APIを構築する際、ドキュメントには機能として現れず、問題が起きないという 形でしか現れない判断をいくつか下す必要がありました。ここでは、その理由を説明します - なぜコイン 課金なのか、生成が失敗したときに何が起きるのか、そしてドキュメントに書かれたいくつかの数字（レー ト制限、保存日数）が見た目ほど意味を持たない理由です。

サブスクリプションではなくコイン

画像生成には呼び出しごとに実際の、変動するコストがかかります。月額固定のサブスクリプションでは、 月に5枚しか生成しない人には払いすぎになり、500枚生成する人には払わなさすぎになります - これに きれいに当てはまる席数やリクエスト枠は存在しません。コインなら、コストを利用量に直接連動させられ ます。実際に生成した分だけ払い、それ以上は払いません。コインには有効期限がなく、解約するものも ないため、請求サイクルを気にする必要もありません - 必要なときにパッケージを買えば、使うまで ウォレットの中でただ待っています。

失敗した生成は自動で返金される

生成がタイムアウトしたり、画像が完成する前に拒否されたりした場合、そのために使ったコインは自動的 に、即座に戻ってきます。これはサポートに問い合わせて解決するものではなく、システム自体の性質で す - 受け取れなかった画像に対して課金されることは決してありません。私たちはこれを、単なる好意で はなく、信頼性の保証として扱っています。

すべての失敗は、意図的に少なく絞られた4つのコードのいずれかに解決されます。

• TIMEOUT - 生成に時間がかかりすぎ、打ち切られた。
• MODERATION_REJECTED - リクエストがコンテンツポリシーに違反した。
• VENDOR_ERROR - 生成側で何らかの失敗が発生した。
• UNKNOWN - 上記3つに当てはまらないものすべてを受け止める、正真正銘のキャッチオール。

コードの種類を小さく固定しているのは意図的な選択です - あとから変わるかもしれない自由形式のエ ラー文字列をパターンマッチングするのではなく、実際にswitch文を書ける対象にしたかったからです。

画像は30日で期限切れになる

生成された画像データは30日間保持されます。それ以降も、生成の履歴レコード自体は残ります - 一覧 エンドポイントには、いつ、いくらで生成が行われたかが引き続き表示されます - しかし実際の画像内容 を取得しようとするとHTTP 410 Goneが返ります。これは隠されたものではない、単純なストレージコスト のトレードオフです。30日を超えて画像を保持したい場合は、ダウンロードして自分で保存してください。 生成の記録を黙って削除することはなく、消えるのはデータだけです。

レート制限は本当の上限ではない

APIキーの1分あたりのレート制限（デフォルトで生成が1分あたり20リクエスト、読み取りが120リクエス ト）は、乱用を抑えるために存在するものであり、実際に何枚生成できるかを決めるものではありません。 本当の上限はFellowiコインの残高です - コインがある限り、そのレートの範囲内で使うことができます。 残高よりも厳しい予算にしたい場合は、キーごとに任意の1日あたりのコイン上限を自分で設定することも できます。これは私たちのためではなく、あなた自身のコスト管理のためです。

取り戻せない鍵

APIキーは作成時に一度だけ表示されます。それ以降、私たちの側にはハッシュ値と短いプレビューだけが 保存されます - 製品内の他のシークレットと同じ扱いです。キーを紛失した場合は新しいものを作成して ください。復元フローは存在しません。なぜなら、私たちの側にそもそも復元できるものが残っていない からです。

同じウォレット、同じ価格

APIとウェブアプリは、まったく同じFellowiコインの残高から、画質ティ アごとにまったく同じ価格を支払います - 標準画質が40コイン、高画質が60コインです。「API専用の料 金」というものは存在しません。これは意図的な設計です - どちらの入り口から生成しても、コストは 予測可能なままです。

実際のリクエスト/レスポンスの形式と動作するコードサンプルについては、APIクイックスタートをご覧ください。あるいはAPI Consoleに直接アクセスして、キーを作成してください。