Claves API
Recuperar una clave API
Usa CometAPI GET /api/token/ para recuperar un registro de clave API por ID para la cuenta autenticada.
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
}
}Usa este endpoint para recuperar un registro de clave API por ID.
El parámetro de ruta
Genera un token de acceso personal en Consola → Configuración personal, y luego envíalo como el valor sin formato del encabezado
Authorization. No le añadas el prefijo Bearer.id es el ID numérico de la clave devuelto por List API keys.
Estado de la clave API
| Status | Meaning |
|---|---|
1 | Habilitada |
2 | Deshabilitada |
3 | Expirada |
4 | Agotada |
Campos devueltos
| Field | Type | Description |
|---|---|---|
id | integer | ID numérico de la clave API. Usa este valor con Update an API key y Delete an API key. |
key | string | Valor de la clave API devuelto por la API de administración. Trátalo como un secreto y úsalo como Authorization: Bearer $COMETAPI_KEY para solicitudes de modelos. |
status | integer | Estado operativo. Solo 1 significa que la clave está habilitada para solicitudes de modelos. |
name | string | Nombre para mostrar legible por el usuario para la clave. |
created_time | integer | Marca de tiempo Unix en segundos de cuando se creó la clave. |
accessed_time | integer | Marca de tiempo Unix en segundos de la última vez que se usó la clave. |
expired_time | integer | Marca de tiempo Unix en segundos de cuando expira la clave. -1 significa sin vencimiento. |
remain_quota | integer | Cuota restante en unidades internas de cuota de CometAPI. |
used_quota | integer | Cuota ya consumida por esta clave en unidades internas de cuota de CometAPI. |
unlimited_quota | boolean | Indica si la clave omite las comprobaciones de cuota restante. |
model_limits_enabled | boolean | Indica si las restricciones de modelos están activas para esta clave. |
model_limits | string | model IDs permitidos por esta clave, separados por comas, cuando model_limits_enabled es true. Vacío significa que no hay una lista de modelos configurada. |
allow_ips | string or null | Lista permitida de IP como una sola cadena separada por saltos de línea. Cada entrada puede ser una dirección IPv4 única, una dirección IPv6 única, un CIDR IPv4 o un CIDR IPv6. null o "" significa que no hay restricción de IP. |
group | string | Restricción del grupo de la cuenta. Vacío significa que no hay una restricción de grupo explícita. |
cross_group_retry | boolean | Indica si el reintento entre grupos está habilitado para el enrutamiento automático de grupos. |
Autorizaciones
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
Parámetros de ruta
Numeric API key ID returned by the list endpoint.
⌘I
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
}
}