ネオファッション.ai API

ベース URL

すべてのendpointは /api/v1 配下でバージョン管理され、HTTPSで提供されます。Webアプリも同じendpointを使用します。UI専用のprivate routeはありません。

https://app.neofashion.ai/api/v1

認証

すべてのリクエストはBearer tokenで認証されます。2種類のtokenに対応しており、いずれも同じworkspace contextに解決されます。

Authorization: Bearer ne_live_xxxxxxxxxxxx

Authorization: Bearer eyJhbGci...

すべてのリクエストには、監査・請求目的で source field（ui または api）および任意の api_key_id が含まれます。

エンドポイント

主要な生成・読み取りendpointです。動画や一括生成などの長時間タスクは非同期で実行されます。生成をpollするか、アプリでstatus updatesをご確認ください。

レスポンス形式

すべてのendpointは同じenvelopeを返します。data、meta（使用済みcredits、残りcredits、request id）、errorです。dataまたはerrorのいずれか一方のみが設定されます。

{
  "data": {
    "id": "gen_01hwz...",
    "status": "completed",
    "output_url": "https://...",
    "credits_used": 50
  },
  "meta": {
    "credits_used": 50,
    "credits_remaining": 7950,
    "request_id": "req_01hwz..."
  },
  "error": null
}

{
  "data": null,
  "meta": { "request_id": "req_01hwz..." },
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Credit balance too low for this operation.",
    "details": { "required": 50, "available": 20 }
  }
}

レート制限

制限はworkspace単位で適用されます。上限を超えると、APIは 429 RATE_LIMITED と retry-after headerを返します。

エラーコード

エラーは error fieldで返され、安定した code、人が読めるmessage、structured detailsを含みます。