APIセットアップ

Fit-it-on開発者APIとやり取りするには、安全な開発者APIキーを使用してリクエストを認証する必要があります。

APIキーの生成

Fit-it-onダッシュボードにログインします。
左側のサイドバーで、開発者 > APIキーに移動します。
新しいキーを生成ボタンをクリックします。
新しいシークレットキーをコピーします（常にfio_sk_...で始まります）。

このキーは安全に保管してください！ セキュリティ上の理由から、生成ダイアログを閉じると、このキーを再度表示することはできません。紛失した場合は、キーを失効させて新しいキーを生成する必要があります。

認証

すべてのAPIリクエストには、AuthorizationヘッダーにBearerトークンとしてAPIキーを含める必要があります。

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

非同期ワークフロー

Fit-it-onの生成エンドポイント（/v1/runなど）は非同期で動作します。これは、最初の要求が生成の完了を待つことなく、ジョブ追跡IDとともに即座に返されることを意味します。

ステップ1：ジョブの送信

生成ジョブをキューに入れるには、https://fititon.app/api/v1/runにPOSTリクエストを行います。すぐに以下の応答が返されます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

ステップ2：結果のポーリング

返されたidを使用して、https://fititon.app/api/v1/status/{id}にGETリクエストを行うことで、生成のステータスを定期的に確認します。

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

応答には、ジョブの現在の状態が示されます。statusが"completed"の場合、outputフィールドには生成された画像または動画のURLが含まれます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

初めてのリクエスト

現在の残りの開発者クレジットを取得し、プランを確認することで、キーをテストできます。

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

成功した場合、現在のプランと残りのクレジットを含むJSONオブジェクトが返されます。