開発者 · API v1

1つのAPI。
すべてのモデル。

画像・動画・音声・3Dを1つのAPIで。料金はスタジオと同じ残高から。キーは設定で作成します。CLIは近日公開です。

近日公開CLIとSDKは近日公開です。下のREST APIは今日から使えます。

モデル: 672
エンドポイント: 9
最低チャージ額: €3

01 · 例

同じ呼び出しで、あらゆる出力

モデルIDを替えるだけで、画像・動画・音声を切り替えられます。項目はモデルに従います。

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg

landing.dev.outputTitleluma/uni-v1/text-to-image

02 · クイックスタート

3ステップで最初のレンダー

01APIキーを作成設定 > APIキーでキーに名前を付け、一度だけコピーします。お支払いから€3以上でチャージできます。export FEMIMG_API_KEY="YOUR_API_KEY"
02レンダーを開始モデルIDと入力を送ると、ステータスqueuedの生成がすぐに返ります。POST /api/v1/api/catalog/generations
03確認してダウンロードステータスがsucceededになるまで確認し、ファイルをダウンロードします。GET /api/v1/api/catalog/generations/ID/content

03 · CLI近日公開

ターミナルからレンダー

スクリプト、CI、コーディングエージェント向けのコマンドラインツールを準備中です。キーと残高はAPIと共通です。公開までは、このページの呼び出しはすべてcurlで使えます。

スクリプトとCIどのシェルやジョブ、cronからでもレンダーできます。

JSON出力1回の実行につき1つのJSONで、次の処理にそのまま渡せます。

コーディングエージェントエージェントは先に料金を確認し、使う額に上限を設けられます。

04 · APIの基本

本番運用のために

認証

AuthorizationヘッダーにBearerトークンを付けます。キーは設定で作成します。

Authorization: Bearer YOUR_API_KEY

バックグラウンド処理

レンダーを開始するとすぐにqueuedが返ります。succeeded、failed、refundedになるまで確認してください。

{ "status": "queued" }

先に料金を確認

何も実行せずに、入力に対する正確な料金を取得できます。金額はすべてユーロセント単位です。

POST /api/v1/api/catalog/quote

安全な再試行

Idempotency-Keyヘッダーを付ければ、再試行しても二重課金されません。

Idempotency-Key: render-042

制限

キーごとに1分あたりのリクエスト上限があります。超えると429エラーになります。

429 Too Many Requests

エラーと返金

コードとメッセージ付きのJSONエラー。失敗したレンダーは自動で残高に返金されます。

{ "status": "refunded" }

05 · リファレンス

エンドポイント

ベースURL https://femimg.com/api/v1

GET/api/catalog/meキーの名前と上限、残高

GET/api/catalog/modelsモデルのカタログと料金

GET/api/catalog/models/detail?id=MODEL_ID1つのモデルとそのすべての項目

POST/api/catalog/quote入力に対する正確な料金

POST/api/catalog/generations任意のモデルでレンダーを開始

GET/api/catalog/generations最近の生成

GET/api/catalog/generations/ID生成のステータス、料金、結果

GET/api/catalog/generations/ID/content完成したファイルをダウンロード

DELETE/api/catalog/generations/ID生成を削除

€3をチャージして今日から開発

APIとスタジオは同じ残高を使います。失敗したレンダーは返金されます。

APIキーを取得料金を見る

1つのAPI。すべてのモデル。