AXIA Public API

AXIA の機能を外部サービス・アプリケーションから利用できる REST API です。

🔑 すべてのリクエストには有効な API キーが必要です。Developer Dashboard でキーを発行してください。

概要

ベース URL: https://ai-axia.com

すべてのレスポンスは JSON 形式で返されます。成功時は success: true、失敗時は success: false になります。

認証

API キーは以下のいずれかの方法で送信します。

# Authorization ヘッダー（推奨）
Authorization: Bearer axia_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# カスタムヘッダー
X-AXIA-API-Key: axia_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

クレジット

各エンドポイントの呼び出しにはクレジットが消費されます。Owner アカウントは消費なし。残高不足の場合は 402 が返されます。

エンドポイント	消費クレジット
`POST /v1/chat`	2
`POST /v1/agent/run`	10
`POST /v1/lp/generate`	30
`POST /v1/lp/improve`	20
`POST /v1/lp/publish`	5
`GET /v1/revenue/kpi`	5
`GET /v1/me`	0
`GET /v1/usage`	0

GET /v1/me

GET/v1/me

認証中のユーザー情報を取得します

レスポンス例

{
  "success": true,
  "data": {
    "id": "user_xxx",
    "email": "user@example.com",
    "plan": "pro",
    "role": "user",
    "credits": 480
  }
}

GET /v1/usage

GET/v1/usage

API 使用ログと残クレジットを取得します

POST /v1/chat

POST/v1/chat

AI チャット（2 クレジット消費）

リクエスト

{
  "message": "AXIAの特徴を教えてください",
  "model": "gpt-4.1-mini"  // optional
}

レスポンス

{
  "success": true,
  "data": {
    "reply": "AXIAは...",
    "model": "gpt-4.1-mini"
  },
  "usage": {
    "creditsUsed": 2,
    "remainingCredits": 478
  }
}

POST /v1/agent/run

POST/v1/agent/run

AI エージェント実行（10 クレジット消費）

リクエスト

{
  "task": "競合他社の価格分析をしてください",
  "context": "SaaS業界、月額1万円前後"
}

POST /v1/lp/generate

POST/v1/lp/generate

LP コピー生成（30 クレジット消費）

リクエスト

{
  "productName": "AXIA",
  "description": "AI搭載の営業・マーケ自動化ツール",
  "targetAudience": "中小企業の経営者",
  "tone": "professional"
}

POST /v1/lp/improve

POST/v1/lp/improve

LP テキスト改善（20 クレジット消費）

リクエスト

{
  "lpText": "既存のLPテキスト...",
  "focus": "conversion"
}

POST /v1/lp/publish

POST/v1/lp/publish

LP を公開（5 クレジット消費）

リクエスト

{
  "lpId": "lp_xxx"
}

GET /v1/revenue/kpi

GET/v1/revenue/kpi

Revenue KPI 取得（5 クレジット消費）

エラーコード

HTTP	コード	説明
401	missing_api_key	APIキーが未設定
401	invalid_api_key	無効なAPIキー
402	insufficient_credits	クレジット不足
403	insufficient_scope	スコープ不足
404	not_found	リソースが見つかりません
429	rate_limited	レート制限
500	internal_error	内部エラー

{
  "success": false,
  "error": {
    "code": "insufficient_credits",
    "message": "クレジットが不足しています。必要: 10, 残高: 5"
  }
}

SDK（予定）

JavaScript / Python / Go SDK を準備中です。

# JavaScript（予定）
import { AxiaClient } from '@axia/sdk';
const client = new AxiaClient({ apiKey: 'axia_live_xxx' });
const reply = await client.chat('こんにちは');