Перелік API-ключів - CometAPI Documentation

GET

api

token

cURL

curl "https://api.cometapi.com/api/token/?p=1&page_size=20" \
  -H "Authorization: your-access-token"

import requests

url = "https://api.cometapi.com/api/token/"

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/', 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/",
  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/"

	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/")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "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
      }
    ]
  }
}

Використовуйте цей endpoint, щоб отримати список API-ключів, які належать автентифікованому обліковому запису CometAPI. Найновіші ключі повертаються першими.

Згенеруйте personal access token у Console → Personal Settings, а потім передайте його як необроблене значення заголовка Authorization. Не додавайте префікс Bearer.

Пагінація

Query parameter	Description
`p`	Номер сторінки. Типове значення — `1`.
`page_size`	Кількість елементів на сторінці. Значення понад `100` обмежуються до `100`.

Статус API-ключа

Status	Meaning
`1`	Увімкнено
`2`	Вимкнено
`3`	Прострочено
`4`	Вичерпано

Повернені поля

Field	Type	Description
`id`	integer	Числовий ID API-ключа. Використовуйте це значення з Отримати один API-ключ, Оновити API-ключ і Видалити API-ключ.
`key`	string	Значення API-ключа, повернуте management API. Розглядайте його як секрет і використовуйте як `Authorization: Bearer $COMETAPI_KEY` для запитів до model.
`status`	integer	Робочий статус. Лише `1` означає, що ключ увімкнений для запитів до model.
`name`	string	Зрозуміла для користувача відображувана назва ключа.
`created_time`	integer	Unix timestamp у секундах, коли ключ було створено.
`accessed_time`	integer	Unix timestamp у секундах, коли ключ востаннє використовувався.
`expired_time`	integer	Unix timestamp у секундах, коли строк дії ключа спливає. `-1` означає відсутність строку дії.
`remain_quota`	integer	Залишкова квота у внутрішніх одиницях квоти CometAPI.
`used_quota`	integer	Квота, уже використана цим ключем, у внутрішніх одиницях квоти CometAPI.
`unlimited_quota`	boolean	Чи обходить ключ перевірки залишкової квоти.
`model_limits_enabled`	boolean	Чи активні обмеження model для цього ключа.
`model_limits`	string	Розділений комами список model ID, дозволених цим ключем, коли `model_limits_enabled` має значення `true`. Порожнє значення означає, що список model не налаштовано.
`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

за замовчуванням:1

Page number to return. Defaults to 1.

Необхідний діапазон: x >= 1

page_size

integer

за замовчуванням:20

Number of keys per page. Values above 100 are capped at 100 by the backend.

Необхідний діапазон: 1 <= x <= 100

Відповідь

200 - application/json

Paginated API key list.

success

boolean

обов'язково

message

string

обов'язково

data

object

обов'язково

Show child attributes

Отримати поточний API key

Попередня

Створення API key

Наступна

cURL

curl "https://api.cometapi.com/api/token/?p=1&page_size=20" \
  -H "Authorization: your-access-token"

import requests

url = "https://api.cometapi.com/api/token/"

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/', 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/",
  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/"

	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/")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "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-ключа

Повернені поля