Public API リファレンス (v1)

スコープ: generate。 Content Pack を 1 件生成します。クレジット消費は packType に応じて 1〜10。

Request body (抜粋)

{
  "packType": "event_announcement",
  "title": "春の新歓イベント",
  "target": "大学1〜2年生",
  "purpose": "サークル説明会への申込誘導",
  "highlight": "現役メンバーとの交流時間あり",
  "tone": "明るく親しみやすい",
  "cta": "申し込みフォームへ",
  "eventDate": "2026-04-12 18:00",
  "eventLocation": "本郷キャンパス 工学部1号館",
  "signupUrl": "https://example.com/signup",
  "brandId": "00000000-0000-0000-0000-000000000000",
  "medium": ["instagram", "x"]
}

Response (200)

{
  "id": "uuid",
  "pack_type": "event_announcement",
  "created_at": "2026-06-01T12:34:56.789Z",
  "credits_used": 1,
  "output": { /* ContentPack */ },
  "meta": { "model": "gpt-4o", "durationMs": 4321, "mock": false, "degraded": false }
}

curl 例

curl -X POST https://creative.clearnets.org/api/v1/generate \
  -H "Authorization: Bearer ccs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "packType": "product_intro",
    "title": "新作シャンプー",
    "target": "20代女性",
    "highlight": "アミノ酸系・無香料"
  }'

スコープ: read。 自分の生成履歴を新しい順に取得します。

Query

• limit (default 20, max 100)
• cursor (ISO datetime; 前回の next_cursor を渡す)

Response

{
  "data": [
    {
      "id": "uuid",
      "pack_type": "product_intro",
      "created_at": "2026-06-01T12:34:56.789Z",
      "status": "succeeded",
      "credits_used": 1,
      "model_used": "gpt-4o",
      "output": { /* ContentPack */ }
    }
  ],
  "next_cursor": "2026-05-30T10:00:00.000Z"
}

curl 例

curl https://creative.clearnets.org/api/v1/generations?limit=10 \
  -H "Authorization: Bearer ccs_live_xxx"

スコープ: read、所有者一致のみ。 他人の生成 ID を指定すると 404 NOT_FOUND を返します。

curl https://creative.clearnets.org/api/v1/generations/00000000-... \
  -H "Authorization: Bearer ccs_live_xxx"

スコープ不問。 自身のプラン・クレジット残高・有効スコープを取得します。 CI で「キーが有効か」を確認するヘルスチェックにも使えます。

Response

{
  "user_id": "uuid",
  "email": "you@example.com",
  "plan": "business",
  "credit_balance": 4200,
  "scopes": ["generate", "read"]
}