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 키 레코드 1개를 조회합니다.

Console → Personal Settings에서 personal access token을 생성한 다음, 이를 원시 Authorization 헤더 값으로 전송하세요. 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 내부 quota 단위 기준의 남은 quota입니다.
`used_quota`	integer	이 키가 이미 사용한 CometAPI 내부 quota 단위입니다.
`unlimited_quota`	boolean	이 키가 남은 quota 검사 제한을 우회하는지 여부입니다.
`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	자동 그룹 라우팅을 위해 cross-group retry가 활성화되어 있는지 여부입니다.

인증

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 키 생성

API 키 삭제

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 키 상태

반환 필드