分发令牌管理 API

トークン管理 API

すべての Token を取得

• インターフェース名：すべての Token を取得
• HTTP メソッド：GET
• パス：/api/token/
• 認証要件：ユーザー
• 機能概要：現在のユーザーが保有するすべての Token をページネーション付きで取得します

💡 リクエスト例：

const response = await fetch('https://api.4allapi.com/api/token/?p=1&size=20', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ 成功レスポンス例：

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 1,
        "name": "API Token",
        "key": "<YOUR_API_KEY>",
        "status": 1,
        "remain_quota": 1000000,
        "unlimited_quota": false,
        "expired_time": 1640995200,
        "created_time": 1640908800,
        "accessed_time": 1640995000
      }
    ],
    "total": 5,
    "page": 1,
    "page_size": 20
  }
}

❗ 失敗レスポンス例：

{
  "success": false,
  "message": "获取Token列表失败"
}

🧾 フィールド説明：

• p （数値）: ページ番号。デフォルトは 1
• size （数値）: 1ページあたりの件数。デフォルトは 20
• items （配列）: Token 情報の一覧
• total （数値）: Token の総数
• page （数値）: 現在のページ番号
• page_size （数値）: 1ページあたりの件数

単一 Token を取得

• インターフェース名：単一 Token を取得
• HTTP メソッド：GET
• パス：/api/token/:id
• 認証要件：ユーザー
• 機能概要：指定した Token の詳細情報を取得します

💡 リクエスト例：

const response = await fetch('https://api.4allapi.com/api/token/123', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ 成功レスポンス例：

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "name": "API Token",
    "key": "sk-your-token-placeholder",
    "status": 1,
    "remain_quota": 1000000,
    "unlimited_quota": false,
    "model_limits_enabled": true,
    "model_limits": "gpt-3.5-turbo,gpt-4",
    "allow_ips": "192.168.1.1,10.0.0.1",
    "group": "default",
    "expired_time": 1640995200,
    "created_time": 1640908800,
    "accessed_time": 1640995000
  }
}

❗ 失敗レスポンス例：

{
  "success": false,
  "message": "Token不存在"
}

🧾 フィールド説明：

id （数値）: Token ID。URL パスで渡します

Token を作成

• インターフェース名：Token を作成
• HTTP メソッド：POST
• パス：/api/token/
• 認証要件：ユーザー
• 機能概要：新しい API Token を作成します。バッチ作成にも対応しています

💡 リクエスト例：

const response = await fetch('https://api.4allapi.com/api/token/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    name: "My API Token",
    expired_time: 1640995200,
    remain_quota: 1000000,
    unlimited_quota: false,
    model_limits_enabled: true,
    model_limits": ["gpt-3.5-turbo", "gpt-4"],
    allow_ips": "192.168.1.1,10.0.0.1",
    group": "default"
  })
});
const data = await response.json();

✅ 成功レスポンス例：

{
  "success": true,
  "message": ""
}

❗ 失敗レスポンス例：

{
  "success": false,
  "message": "令牌名称过长"
}

🧾 フィールド説明：

• name （文字列）: Token 名。最大 30 文字
• expired_time （数値）: 有効期限のタイムスタンプ。-1 は無期限を表します
• remain_quota （数値）: 残りクォータ
• unlimited_quota （真偽値）: 無制限クォータかどうか
• model_limits_enabled （真偽値）: モデル制限を有効にするかどうか
• model_limits （配列）: 使用を許可するモデル一覧
• allow_ips （文字列）: 許可する IP アドレス。カンマ区切り
• group （文字列）: 所属グループ

Token を更新

• インターフェース名：Token を更新
• HTTP メソッド：PUT
• パス：/api/token/
• 認証要件：ユーザー
• 機能概要：Token の設定を更新します。ステータス切り替えと完全更新に対応しています

💡 リクエスト例（完全更新）：

const response = await fetch('https://api.4allapi.com/api/token/', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    id: 123,
    name: "Updated Token",
    expired_time: 1640995200,
    remain_quota: 2000000,
    unlimited_quota: false,
    model_limits_enabled: true,
    model_limits": ["gpt-3.5-turbo", "gpt-4"],
    allow_ips": "192.168.1.1",
    group": "vip"
  })
});
const data = await response.json();

💡 リクエスト例（状態のみ更新）：

const response = await fetch('https://api.4allapi.com/api/token/?status_only=true', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    id: 123,
    status": 1
  })
});
const data = await response.json();

✅ 成功レスポンス例：

{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "name": "Updated Token",
    "status": 1
  }
}

❗ 失敗レスポンス例：

{
  "success": false,
  "message": "令牌已过期，无法启用，请先修改令牌过期时间，或者设置为永不过期"
}

🧾 フィールド説明：

• id （数値）: Token ID。必須
• status_only （クエリパラメータ）: 状態のみを更新するかどうか
• その他のフィールドは Token 作成インターフェースと同じで、いずれも任意です

Token を削除

• インターフェース名：Token を削除
• HTTP メソッド：DELETE
• パス：/api/token/:id
• 認証要件：ユーザー
• 機能概要：指定した Token を削除します

💡 リクエスト例：

const response = await fetch('https://api.4allapi.com/api/token/123', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ 成功レスポンス例：

{
  "success": true,
  "message": ""
}

❗ 失敗レスポンス例：

{
  "success": false,
  "message": "Token不存在"
}

🧾 フィールド説明：

id （数値）: Token ID。URL パスで渡します

Token を一括削除

• インターフェース名：Token を一括削除
• HTTP メソッド：POST
• パス：/api/token/batch
• 認証要件：ユーザー
• 機能概要：複数の Token をまとめて削除します

💡 リクエスト例：

const response = await fetch('https://api.4allapi.com/api/token/batch', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    ids": [1, 2, 3, 4, 5]
  })
});
const data = await response.json();

✅ 成功レスポンス例：

{
  "success": true,
  "message": "",
  "data": 5
}

❗ 失敗レスポンス例：

{
  "success": false,
  "message": "参数错误"
}

🧾 フィールド説明：

• ids （配列）: 削除する Token ID の一覧。必須かつ空欄不可
• data （数値）: 削除に成功した Token の数

---

4All API フッター

4All API · 一站式AI大模型API聚合平台 | 価格 | お問い合わせ

© 2025 4All API. All rights reserved.