品質エンハンサー（アップスケール）

品質エンハンサーエンドポイントを使用すると、画像の解像度とより細かい詳細をインテリジェントにアップスケールおよび強化し、最大4K解像度までサポートできます。

リクエスト

画像とターゲット解像度をユニバーサルな/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": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

レスポンス

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

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

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

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

リクエストパラメーター

必須パラメーター

ランタイムエラー

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

クレジットコスト

開発者APIリクエストの場合、コストはtargetQualityに応じて変動します。

計算式: コスト = QualityCredits