取得 API 金鑰 - CometAPI Documentation

GET

api

token

{id}

cURL

curl https://api.cometapi.com/api/token/1234 \
  -H "Authorization: your-access-token"

import requests

url = "https://api.cometapi.com/api/token/{id}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.cometapi.com/api/token/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/api/token/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/api/token/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cometapi.com/api/token/{id}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/api/token/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "",
  "data": {
    "id": 1234,
    "user_id": 5678,
    "key": "$COMETAPI_KEY",
    "status": 1,
    "name": "production",
    "created_time": 1766102400,
    "accessed_time": 1766102400,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "used_quota": 0,
    "group": "",
    "cross_group_retry": false
  }
}

使用此端點可依 ID 取得一筆 API 金鑰記錄。

請先在 Console → Personal Settings 產生個人存取 Token，然後將其作為原始 Authorization header 值傳送。不要加上 Bearer 前綴。

id 路徑參數是由列出 API 金鑰回傳的數字金鑰 ID。

API 金鑰狀態

Status	Meaning
`1`	已啟用
`2`	已停用
`3`	已過期
`4`	已耗盡

回傳欄位

Field	Type	Description
`id`	integer	數字 API 金鑰 ID。請將此值搭配更新 API 金鑰與刪除 API 金鑰使用。
`key`	string	由管理 API 回傳的 API 金鑰值。請將其視為機密，並在模型請求中以 `Authorization: Bearer $COMETAPI_KEY` 使用。
`status`	integer	運作狀態。只有 `1` 表示此金鑰已啟用，可用於模型請求。
`name`	string	供使用者辨識的金鑰顯示名稱。
`created_time`	integer	金鑰建立時間的 Unix 時間戳（秒）。
`accessed_time`	integer	金鑰上次使用時間的 Unix 時間戳（秒）。
`expired_time`	integer	金鑰到期時間的 Unix 時間戳（秒）。`-1` 表示永不到期。
`remain_quota`	integer	以 CometAPI 內部配額單位計算的剩餘配額。
`used_quota`	integer	此金鑰已消耗的配額，單位為 CometAPI 內部配額單位。
`unlimited_quota`	boolean	此金鑰是否略過剩餘配額檢查。
`model_limits_enabled`	boolean	此金鑰是否啟用模型限制。
`model_limits`	string	當 `model_limits_enabled` 為 `true` 時，此金鑰允許使用的 model ID，以逗號分隔。空字串表示未設定模型清單。
`allow_ips`	string or null	IP 允許清單，以單一字串表示，項目之間以換行分隔。每個項目可以是單一 IPv4 位址、單一 IPv6 位址、IPv4 CIDR 或 IPv6 CIDR。`null` 或 `""` 表示沒有 IP 限制。
`group`	string	帳戶群組限制。空字串表示沒有明確的群組限制。
`cross_group_retry`	boolean	是否啟用跨群組重試，以進行自動群組路由。

授權

Authorization

string

header

必填

Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.

路徑參數

integer

必填

Numeric API key ID returned by the list endpoint.

回應

200 - application/json

API key record.

success

boolean

必填

message

string

必填

data

object

必填

Show child attributes

建立 API key

刪除 API key

cURL

curl https://api.cometapi.com/api/token/1234 \
  -H "Authorization: your-access-token"

import requests

url = "https://api.cometapi.com/api/token/{id}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.cometapi.com/api/token/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/api/token/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/api/token/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cometapi.com/api/token/{id}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/api/token/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "",
  "data": {
    "id": 1234,
    "user_id": 5678,
    "key": "$COMETAPI_KEY",
    "status": 1,
    "name": "production",
    "created_time": 1766102400,
    "accessed_time": 1766102400,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "used_quota": 0,
    "group": "",
    "cross_group_retry": false
  }
}

​API 金鑰狀態

​回傳欄位

授權

路徑參數

回應

API 金鑰狀態

回傳欄位