OPS/iO Portrait API

curl -X POST https://io.order-photo.com/api/v1/profiles \
  -H "Authorization: Bearer ops_sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "display_name": "Sato Hanako", "capture_mode": "face_only", "photos": [ { "angle": "face_front", "url": "https://example.com/photos/front.jpg" }, { "angle": "face_front_smile", "url": "https://example.com/photos/smile.jpg" }, { "angle": "face_left45", "url": "https://example.com/photos/left45.jpg" }, { "angle": "face_right45", "url": "https://example.com/photos/right45.jpg" } ] }'

{
  "id": "b6a4f6de-0000-0000-0000-000000000001",
  "status": "pending",
  "display_name": "Sato Hanako",
  "capture_mode": "face_only",
  "progress_pct": 0,
  "created_at": "2026-08-12T00:00:00Z",
  "updated_at": "2026-08-12T00:00:00Z"
}

curl -X GET https://io.order-photo.com/api/v1/profiles \
  -H "Authorization: Bearer ops_sk_..."

{
  "data": [
    {
      "id": "b6a4f6de-0000-0000-0000-000000000001",
      "status": "ready",
      "display_name": "Sato Hanako",
      "capture_mode": "face_only",
      "created_at": "2026-08-12T00:00:00Z"
    }
  ],
  "has_more": false
}

curl -X GET https://io.order-photo.com/api/v1/profiles/<id> \
  -H "Authorization: Bearer ops_sk_..."

{
  "id": "b6a4f6de-0000-0000-0000-000000000001",
  "status": "ready",
  "display_name": "Sato Hanako",
  "capture_mode": "face_only",
  "progress_pct": 100,
  "created_at": "2026-08-12T00:00:00Z",
  "updated_at": "2026-08-12T00:05:00Z"
}

curl -X DELETE https://io.order-photo.com/api/v1/profiles/<id> \
  -H "Authorization: Bearer ops_sk_..."

{
  "deleted": true
}

curl -X POST https://io.order-photo.com/api/v1/generations \
  -H "Authorization: Bearer ops_sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "b6a4f6de-0000-0000-0000-000000000001", "style_preset_id": "a1f0c9aa-0000-0000-0000-000000000003", "framing": "bust-up", "aspect_ratio": "3:4", "count": 1, "quality": "high" }'

{
  "id": "e2d81f77-0000-0000-0000-000000000002",
  "status": "processing",
  "profile_id": "b6a4f6de-0000-0000-0000-000000000001",
  "count": 1,
  "created_at": "2026-08-12T00:10:00Z"
}

curl -X GET https://io.order-photo.com/api/v1/generations \
  -H "Authorization: Bearer ops_sk_..."

{
  "data": [
    {
      "id": "e2d81f77-0000-0000-0000-000000000002",
      "status": "completed",
      "profile_id": "b6a4f6de-0000-0000-0000-000000000001",
      "images": [
        {
          "url": "https://…（1時間有効の署名URL）",
          "expires_in": 3600
        }
      ],
      "created_at": "2026-08-12T00:10:00Z",
      "completed_at": "2026-08-12T00:12:30Z"
    }
  ],
  "has_more": false
}

curl -X GET https://io.order-photo.com/api/v1/generations/<id> \
  -H "Authorization: Bearer ops_sk_..."

{
  "id": "e2d81f77-0000-0000-0000-000000000002",
  "status": "completed",
  "profile_id": "b6a4f6de-0000-0000-0000-000000000001",
  "progress_pct": 100,
  "images": [
    {
      "url": "https://…（1時間有効の署名URL）",
      "expires_in": 3600
    }
  ],
  "created_at": "2026-08-12T00:10:00Z",
  "completed_at": "2026-08-12T00:12:30Z"
}

curl -X GET https://io.order-photo.com/api/v1/styles \
  -H "Authorization: Bearer ops_sk_..."

{
  "data": [
    {
      "id": "a1f0c9aa-0000-0000-0000-000000000003",
      "name": "ビジネス・スタジオ",
      "category": "business",
      "follow_pose": false
    }
  ]
}

curl -X GET https://io.order-photo.com/api/v1/usage \
  -H "Authorization: Bearer ops_sk_..."

{
  "period_images_used": 42,
  "period_profiles_built": 3,
  "hard_cap_images": 1000,
  "hard_cap_remaining": 958,
  "estimated_charges_jpy": 15900,
  "unit_prices": {
    "profile_jpy": 1100,
    "image_jpy": 300
  }
}

curl -X POST https://io.order-photo.com/api/v1/webhook-endpoints \
  -H "Authorization: Bearer ops_sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/webhooks/opsio", "events": [ "generation.completed", "generation.failed" ] }'

{
  "id": "c3b2a1d0-0000-0000-0000-000000000004",
  "url": "https://example.com/webhooks/opsio",
  "events": [
    "generation.completed",
    "generation.failed"
  ],
  "secret": "whsec_（この時だけ表示）",
  "active": true
}

curl -X GET https://io.order-photo.com/api/v1/webhook-endpoints \
  -H "Authorization: Bearer ops_sk_..."

{
  "data": [
    {
      "id": "c3b2a1d0-0000-0000-0000-000000000004",
      "url": "https://example.com/webhooks/opsio",
      "events": [
        "generation.completed",
        "generation.failed"
      ],
      "active": true
    }
  ]
}

curl -X DELETE https://io.order-photo.com/api/v1/webhook-endpoints/<id> \
  -H "Authorization: Bearer ops_sk_..."

{
  "deleted": true
}

curl https://io.order-photo.com/api/v1/openapi.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "OPS/iO Portrait API"
  }
}