Recuperar uma chave de API

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
  }
}

Use este endpoint para recuperar um registro de chave de API por ID.

Gere um personal access token em Console → Personal Settings e, em seguida, envie-o como o valor bruto do cabeçalho Authorization. Não o prefixe com Bearer.

O parâmetro de caminho id é o ID numérico da chave retornado por List API keys.

Status da chave de API

Status	Significado
`1`	Ativada
`2`	Desativada
`3`	Expirada
`4`	Esgotada

Campos retornados

Field	Type	Description
`id`	integer	ID numérico da chave de API. Use este valor com Update an API key e Delete an API key.
`key`	string	Valor da chave de API retornado pela API de gerenciamento. Trate-o como um segredo e use-o como `Authorization: Bearer $COMETAPI_KEY` para solicitações de modelo.
`status`	integer	Status operacional. Apenas `1` significa que a chave está ativada para solicitações de modelo.
`name`	string	Nome de exibição legível pelo usuário para a chave.
`created_time`	integer	Timestamp Unix em segundos de quando a chave foi criada.
`accessed_time`	integer	Timestamp Unix em segundos de quando a chave foi usada pela última vez.
`expired_time`	integer	Timestamp Unix em segundos de quando a chave expira. `-1` significa sem expiração.
`remain_quota`	integer	Cota restante em unidades internas de cota do CometAPI.
`used_quota`	integer	Cota já consumida por esta chave em unidades internas de cota do CometAPI.
`unlimited_quota`	boolean	Se a chave ignora as verificações de cota restante.
`model_limits_enabled`	boolean	Se as restrições de modelo estão ativas para esta chave.
`model_limits`	string	model IDs separados por vírgula permitidos por esta chave quando `model_limits_enabled` é `true`. Vazio significa que não há lista de modelos configurada.
`allow_ips`	string or null	Lista de IPs permitidos como uma única string separada por quebras de linha. Cada entrada pode ser um único endereço IPv4, um único endereço IPv6, IPv4 CIDR ou IPv6 CIDR. `null` ou `""` significa sem restrição de IP.
`group`	string	Restrição de grupo da conta. Vazio significa sem restrição explícita de grupo.
`cross_group_retry`	boolean	Se a repetição entre grupos está ativada para roteamento automático de grupos.

Autorizações

Authorization

string

header

obrigatório

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

Parâmetros de caminho

integer

obrigatório

Numeric API key ID returned by the list endpoint.

Resposta

200 - application/json

API key record.

success

boolean

obrigatório

message

string

obrigatório

data

object

obrigatório

Show child attributes

Criar uma API key

Excluir uma 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
  }
}

Moderação de conteúdo

Chaves de API

Status da chave de API

Campos retornados

Autorizações

Parâmetros de caminho

Resposta

​Status da chave de API

​Campos retornados

Autorizações

Parâmetros de caminho

Resposta

Status da chave de API

Campos retornados