Logo

ソーシャルスタジオ

ソーシャルメディア向けに、高度に様式化されたクリエイティブなエフェクトとテンプレートをファッション画像に適用します。

ソーシャルスタジオ

ソーシャルスタジオエンドポイントは、高度に様式化されたクリエイティブな美的テンプレートをファッション画像に適用し、ソーシャルメディアマーケティングに最適な目を引くコンテンツに変えます。

モデル名: social-studio

ライフサイクル: stable

処理時間: 約15秒～30秒

出力形式: 自動 (JPEGまたはPNG)

配信方法: URL

クレジット: 生成ごとに2～5 (品質による)

リクエスト

画像と選択したスタイルIDをユニバーサルな/v1/runエンドポイントに送信します。

POSThttps://fititon.app/api/v1/run

リクエスト例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

レスポンス

画像生成には最大30秒かかる場合があるため、/v1/runエンドポイントは非同期ジョブのidとともに201 Createdステータスを即座に返します。最終的な画像を取得するには、このidを使用してステータスAPIをポーリングする必要があります。または、Webhooksを設定して通知を自動的に受け取ることもできます。当社のWebhookディスパッチャーは厳格な15秒のタイムアウトを適用することにご注意ください。サーバーは15秒以内に2xxステータスコードでWebhookを承認する必要があります。そうでない場合、失敗と見なされ、後で再試行されます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

ジョブが完了すると（status: "success"）、outputフィールドには結果のURLの配列が含まれます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

リクエストパラメータ

必須パラメータ

personImageRequiredstring

様式化するソース画像。公開されているURLまたはBase64エンコードされた画像文字列を指定できます。

プロのヒント: 全身が写っている写真が、最も様式化された結果を生み出します。顔がはっきりと見えることが重要です。AIは顔の特徴を使用して様式化されたバージョンを作成します。集合写真や、オブジェクトの陰に隠れている画像は避けてください。

フォーマット要件 Base64文字列を送信する場合、標準のデータURIプレフィックス（例：data:image/jpeg;base64,...）を含める必要があります。personImageはBase64文字列を受け入れますが、リクエストのグローバルJSONペイロードサイズ制限（HTTP 413）に達するのを避けるため、3MBを超える画像には標準のHTTP URLを使用することを強くお勧めします。

styleIdRequiredstring

生成された画像に適用する写真スタイルID。これにより、ライティング、美学、ムードが決まります。

利用可能なスタイル:

Style NameStyle ID (`styleId`)

オプションパラメータ

quality'1k' | '2k' | '4k'

出力解像度ティア。 デフォルト: 1k

sampleCountinteger

リクエストごとに生成する画像のバリエーション数。1から4の間である必要があります。 デフォルト: 1

ratiostring

アスペクト比のオーバーライド。空の場合、システムは1:1（Instagram/ソーシャルフィードに最適）をデフォルトとします。

サポートされている値: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

ランタイムエラー

この機能のランタイムエラーは、エラー処理に記載されている共通のセットを使用します。処理中にエラーが発生した場合、statusは"error"に更新され、errorフィールドには具体的な失敗理由が含まれます。

クレジットコスト

開発者APIリクエストの場合、コストは選択された出力qualityティアにsampleCountを乗じたものによって決まります。

計算式: コスト = 品質クレジット × sampleCount

品質ティア画像あたりのクレジット
1k (デフォルト)2
2k3
4k5